Environment Variables

This topic is mostly for reference. We recommend using the start script to set up your environment. This process will prompt the user for the needed information and set the environment variables.

NOTE
The start script is at the root of the installation directory and is run as sudo ./ubuntu-start.sh.
All other scripts live in the toolkit/ folder, have plain names, and are also run with sudo — for example sudo ./toolkit/backup.sh.
See Script Naming and Usage.

The following environment variables apply to your Link-Live Private installation.

Where the Saved Environment File Lives

The start script writes your settings to /etc/link-live/ll.env and reloads that file on each subsequent run.

CAUTION! Back up this file before editing it by hand. The start script writes a .bak copy automatically, but hand-editing is the most common way to break a working installation. Change settings by rerunning the start script with the argument for the area you want to update, such as host, auth, or mail, rather than editing the file by hand.

Variable Reference

Variable

Details

DISABLE_SIGNUP_BUTTON

By default, users can create a new account by clicking Create account on the Link-Live login page. Set this variable to true to disable account creation from the login page. New users can then create a Link-Live Private account once they are invited to an Organization.

SERIAL

Link-Live Private serial number. (Contact NetAlly Support to acquire your serial number if you have not received one.)

APP_DOCKER_HOST

The hostname/IP that users and tester units will connect to. It must be static and accessible.

NOTE: Do not set this to 127.0.0.1 or localhost. Uploads will remain stuck on Processing and tester units will not be able to connect. See Troubleshoot.

TAG

Link-Live software version, found in version.txt at the root of the bundle.

TOKEN_PUBLIC_KEY and
TOKEN_PRIVATE_KEY

Base64-encoded, RS256 PEM files for authentication JWTs.

NOTE: These are not the base64 contents of the PEM files, but the entire PEM file encoded in base64. Changing these variables between runs may unclaim tester units and log users out.

BEDROCK_TEST_USER and
SUPER_USER

Email address for Superuser account. These two variables must be identical.

BEDROCK_TEST_SECRET
and SUPER_PASS

Password for Superuser account. These two variables must be identical.

LICENSE_EXPIRE_
NOTIFICATION_METHOD

Set to none, email, or inapp for the type of license expiration alert.

Link-Live Private attempts to notify users when the Link-Live Private license requires renewal, both 30 and 60 days prior to its expiration.

  • inapp - sends an in-app notification to all users. (This is the default.)

  • none - disables these notifications entirely.

  • email - sends an email to the email address set for the superuser account, meaning the SUPER_USER environment variable value.