search
DemoBlogDiscord

Start DoltLab

The following describes how to start the latest versions of DoltLab, >= v2.1.4, that contain the installer binary. For instructions on how to start an older version of DoltLab that do not have the installer, please see the pre-installer guide.

In the simplest configuration the installer will generate four local DoltLab assets: a docker-compose.yaml file, an envoy.json file, a start.sh script, and a stop.sh script.

Use start.sh to start your DoltLab instance and stop.sh, to stop it. These scripts will reference the other local files generated by the installer as well.

DoltLab's installer uses a configuration file, ./installer_config.yaml, that ships with DoltLab. The default configuration contains the following:

version: v2.1.4

# "Host" is the hostname or IP address of host running DoltLab. Required.
host: ""

# "Services" contains config for specific DoltLab services.
# The first time DoltLab runs, it uses the passwords defined in `doltlabdb.admin_password`
# and `doltlabdb.dolthubapi_password` to initialize DoltLab's application database.

services:
  doltlabdb:
    admin_password: "DoltLab1234"
    dolthubapi_password: "DoltLab1234"

# "Default User" configures the default user account created by DoltLab the first time it starts up. This account is able to use
# all of DoltLab's features, without connecting DoltLab to an SMTP server.
default_user:
  name: "admin"
  password: "DoltLab1234"
  email: "admin@localhost"
## "SMTP" is used to configure a connection to an existing SMTP server. Optional.
## For more information on connecting your instance to an SMTP server,
## see https://docs.doltlab.com/guides/administrator#connect-smtp-server.
#smtp:
#  auth_method: "plain"
#  host: ""
#  port: 0
#  no_reply_email: ""

Edit installer_config.yaml and supply the host name or IP address of your DoltLab host in the host field.

Additionally, edit the default passwords in the following sections to be more secure values:

It is important to change these passwords before starting DoltLab with the ./start.sh script for the first time, since on DoltLab's first run, the application database backing DoltLab will be initialized with these passwords and persisted to disk.

These passwords can be changed later on, but requires a couple additional steps.

Save these changes, then run the installer:

Notice the output produced by the installer as shown below:

The installer will tell you how to start and stop DoltLab using the scripts it generated.

Importantly, the first time DoltLab starts, a default user, admin, with email admin@localhost is created. This user will be the only user able create databases on the DoltLab instance until the instance is connected to a valid SMTP server. The email associated with the default user can be updated to a valid email at anytime before starting DoltLab for the first time, or if DoltLab has already created the default user, from the Profile > Settings page of the running DoltLab instance.

Additionally, the first time the DoltLab is started, it will use the values in services.doltlabdb.admin_password and services.doltlabdb.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.

You can now run ./start.sh to start DoltLab:

After running ./start.sh, DoltLab's running services can be viewed with docker ps:

Navigating to http://${HOST_IP}:80 in a web browser, where HOST_IP is the domain name or IP address of your DoltLab host, should show the DoltLab homepage.

For more ways to configure and run your DoltLab instance, checkout DoltLab's Administrator Guide.

hashtag
Running with Podman

If you prefer Podman, the installer can generate Podman-ready assets. Select the Podman runtime with either:

or by adding the following to installer_config.yaml:

When the Podman runtime is selected, start.sh uses podman-compose, exports UID/GID for rootless volumes, removes unsupported depends_on entries in the compose file, and maps the rootless socket at /run/user/${UID}/podman/podman.sock.

hashtag
Next Steps

PreviousLinuxNextBasic

Last updated