NOTE: This is only for legacy installations. Please follow this installation guide for new installations.


xltrail is installed by using the following commands:

curl -sSL -o
sudo bash ./

You are asked a few questions and at the end of the installation process you'll be told to continue on <server>:8800. Type this address in your browser to continue with the installation.

Since the page is using a self-signed certificate, you will see a security warning, but after continuing (depending on your browser you'll have to click on "advanced"), you'll be presented with the following screen:

  • Type in your Hostname, e.g. (use your IP address in case you don't have a domain name yet)
  • Private Key/Certificate:
    • If you are using xltrail behind your firewall and want to access the app via http rather than https, click on Use Self-Signed Cert to continue. xltrail will be served on http while this management console remains on https.
    • If you are using xltrail in the cloud, you must encrypt your traffic by using SSL/TLS certificates. In case the certificates are already on your server, click on If your private key and cert are already on this server, click here and provide the paths. Alternatively, you can upload the private key/cert via the provided buttons.

License file

Next, you'll be prompted to upload the xltrail license file that you received from us via email.

Admin password

In the next screen, set an admin password for this management console. If you don't use LDAP for user management, then you will also need this password for the xltrail admin user. See Maintenance for instructions on how to change the password.


To finalize the installation, you are presented with the "Preflight Checks" that point out any possible issues. After continuing, you are presented with the Settings page where you can decide if xltrail should be served via https and if you want to use LDAP for user management.

Finally, hit Save and Apply Changes. This will take you to the management console dashboard and xltrail will start.

Login to xltrail

Once xltrail is up and running, enter the hostname in your browser (e.g. or click on Open in the management console. Then login as admin:

  • With LDAP: Use a user of the restricted group
  • Without LDAP: Use admin as username and the password you previously set in the management console

Setup users

  • With LDAP: no action required as users will be provisioned as admin or user according to their group
  • Without LDAP: Go to Settings on the top right, then setup users manually under Team.

Connect with your workbooks

To connect to your first Git repository, continue here.

results matching ""

    No results matching ""