2.1 KiB
Configuration
Once Xen Orchestra is installed, you can configure some parameters in the configuration file. Let's see how to do that.
Configuration
The configuration file is in /etc/xo-server/config.yaml.
WARNING: YAML is very strict with indentation: use spaces, not tabs.
User to run XO-server as
By default, XO-server is running as 'root'. You can change that by uncommenting these lines and choose whatever user/group you want:
user: 'nobody'
group: 'nogroup'
Warning! A non-priviledged user:
- can't bind to a port < 1024
- can't mount NFS shares
HTTP listen address and port
By default, XO-server listens to all addresses (0.0.0.0) and runs on port 80. You can change this if you want in the # Basic HTTP section:
host: '0.0.0.0'
port: 80
HTTPS
XO-server can also run in HTTPS (both HTTP and HTTPS can cohabit) - just modify what's needed in the # Basic HTTPS section, this time with certificates/keys you want and their path:
host: '0.0.0.0'
port: 443
certificate: './certificate.pem'
key: './key.pem'
If a chain of certificates authorities is needed, you may bundle them directly in the certificate. Note: the order of certificates does matter, your certificate should come first followed by the certificate of the above certificate authority up to the root.
Link to XO-web
You shouldn't have to change this. It's the path were "xo-web" files are served by "xo-server.
mounts:
'/':
- '../xo-web/dist/'
Redis server
By default, XO-server will try to contact Redis server on localhost, with the port 6379. But you can define anything else you want:
uri: 'tcp://db:password@hostname:port'
External auth (LDAP)
You should see at the end of the config file, something like this:
plugins:
auth-ldap:
auth-github:
The plugin configuration is now done in the interface, in the plugin section of "Settings".
Log file
On XOA, the log file for XO-server is in /var/log/syslog. It contains all the server information returned and can be a real help when you have trouble.