Configuring Timeline Using Environment File
The Timeline settings may be configured after the installation.
At the system hosting Timeline, open the opt/timeline/.env file in any editor and set the following environment variables:
Parameters | Information | |
---|---|---|
Database connection settings | ||
ADMIN_DATABASE_URL LOG_DATABASE_URL USER_DATABASE_URL_PREFIX |
Description | Configures access to timeline, timeline-log and timeline-000 databases. |
Format |
<IP address or postgres hostname> should be the machine's IP or public name so it can be accessed from Docker containers. By default, PostgreSQL uses port 5432. Make sure that the configured port is not being used by any other application and is open on the firewall. If using the default PostgreSQL port, it can be done by: |
|
Example |
ADMIN_DATABASE_URL=postgres://trx:x@172.18.0.1:5432/timeline LOG_DATABASE_URL=postgres://trx:x@172.18.0.1:5432/timeline-log USER_DATABASE_URL_PREFIX=postgres://trx:x@172.18.0.1:5432/timeline- |
|
Web server configuration | ||
PROXY_PORT PROXY_SSL_PORT |
Description |
Specifies the ports configuration available for the application on the host machine. By default, the application listens on port 80 for HTTP and port 443 for HTTPS. If both ports are defined, HTTP requests will be redirected to HTTPS. For details on SSL configuration, see section 'HTTPS configuration'. Important.
|
Format |
PROXY_PORT=<HTTP port> PROXY_SSL_PORT=<HTTPS port> 0 (zero) means the port is disabled. |
|
Example |
PROXY_PORT=0 PROXY_SSL_PORT=443 |
|
BASE_URL | Description |
Specifies the Base URL that hosts Timeline. The hostname should include the port number if it is not the default and the protocol (http/https) of the server where the application is going to run. The BASE_URL variable is used for links inside email messages sent by Timeline. |
Format | BASE_URL={protocol}://hostname[:port] | |
Example |
BASE_URL=http://10.15.61.165 BASE_URL=https://mytimeline.com |
|
Mail server configuration | ||
MAIL_SERVER_HOST MAIL_SERVER_PORT MAIL_SERVER_USERNAME MAIL_SERVER_PASSWORD MAIL_SERVER_TLS_CONNECTION MAIL_SERVER_REQUIRE_TLS MAIL_SERVER_REJECT_UNAUTHORIZED EMAIL_SENDER |
Description |
Specifies SMTP server access to allow Timeline sending out emails in several features such as Alerting, User invitation, etc. Provide SMTP mail server access credentials such as host, port, username, password, e-mail sender address, and mail server security options.
|
Format |
MAIL_SERVER_HOST=<mail server IP address or hostname> MAIL_SERVER_PORT=<mail server port> MAIL_SERVER_USERNAME=<mail server username> MAIL_SERVER_PASSWORD=<mail server password> MAIL_SERVER_TLS_CONNECTION=<true/false> MAIL_SERVER_REQUIRE_TLS=<true/false> MAIL_SERVER_REJECT_UNAUTHORIZED=<true/false> EMAIL_SENDER=<mail sender e-mail> |
|
Example |
MAIL_SERVER_HOST=example.smtp.server.com MAIL_SERVER_PORT=465 MAIL_SERVER_USERNAME=mail_user MAIL_SERVER_PASSWORD=mail_password MAIL_SERVER_TLS_CONNECTION=false MAIL_SERVER_REQUIRE_TLS=true MAIL_SERVER_REJECT_UNAUTHORIZED=false EMAIL_SENDER=timeline-support@example.com |
|
Timeline folders | ||
LOGS LICENSE |
Description |
Specifies the locations of directories the app saves data to. Each of these should be directories on the host machine. If you specify relative paths, they will be relative to the installation directory.
By default, all directories are under the installation directory. |
Example |
LOGS=/opt/timeline/logs NGINX_CONF=/opt/timeline/nginx STORAGE_DIR=/opt/timeline/storage LICENSE=/opt/timeline/license |
22.09.2023 8:59:47