Start DoltLab pre-installer
The following describes how to start an older version of DoltLab, <= v2.0.8
, that does not contain the installer
binary that the latest versions of DoltLab do. These versions of DoltLab use the .start-doltlab.sh
script included in DoltLab's .zip
file.
This script requires the following environment variables to be set in your DoltLab host environment/shell.
Note, the
./start-doltlab.sh
script contains references to some of these environment variables, but not all, as some are referenced elsewhere.
For DoltLab version <=
v0.8.4
includeexport POSTGRES_USER="dolthubapi"
and renameDOLT_PASSWORD
toPOSTGRES_PASSWORD
.
It's import to note that the first time you run ./start-doltlab.sh
, DoltLab uses the supplied DOLT_PASSWORD
and DOLTHUBAPI_PASSWORD
to initialize DoltLab's application database using the following SQL statements:
DoltLab's main API, doltlabapi
, will connect to the application database as the dolthubapi
SQL user.
Supported SMTP Authentication methods
Starting in DoltLab v0.3.1
, admins can use different SMTP authentication protocols to connect to an existing SMTP server. By default, ./start-doltlab.sh
sets the environment variable EMAIL_AUTH_METHOD
to plain
.
Supported EMAIL_AUTH_METHOD
options are plain
, login
, anonymous
, external
, oauthbearer
, or disable
.
plain
requires the environment variables EMAIL_USERNAME
and EMAIL_PASSWORD
to be set and uses the optional environment variable EMAIL_IDENTITY
. login
requires the environment variables EMAIL_USERNAME
and EMAIL_PASSWORD
to be set. This is used by Microsoft 365 (smtp.office365.com
). anonymous
uses the optional environment variable EMAIL_TRACE
. external
uses the optional environment variable EMAIL_IDENTITY
. oauthbearer
requires the environment variables EMAIL_USERNAME
and EMAIL_OAUTH_TOKEN
to be set. disable
will result in an unauthenticated SMTP server connection.
Default user admin
admin
This default user allows DoltLab admins to immediately sign in to DoltLab and begin using the product, even if their DoltLab instance is not successfully connected to an SMTP server.
By default, the ./start-doltlab.sh
script will create a default user DEFAULT_USER=admin
with password DEFAULT_USER_PASSWORD=DoltLab1234
and the email address DEFAULT_USER_EMAIL=$NO_REPLY_EMAIL
, which gets its value from the supplied NO_REPLY_EMAIL
environment variable.
To overwrite these default values, simply change the values of their corresponding environment variables.
Once these variables are set, simply run the start-doltlab.sh
script:
The running DoltLab processes can be viewed with docker ps
:
And navigating to http://${HOST_IP}:80
in a web browser should show the DoltLab homepage.
To run DoltLab with TLS instead run:
And navigating to https://${HOST_IP}:443
in a web browser should show the DoltLab homepage.
Next Steps
Last updated