Skip to content

Configuration

seelf can be configured from a yaml file and/or environment variables. Environment variables will always take precedence over the configuration file.

When configured using a file, you can provide it with the -c <your_file.yml> or --config <your_file.yml>.

If the configuration file does not exist, it will be created with the initial configuration.

INFO

Environment variables can also be defined in a .env or .env.local file in the working directory when launching seelf.

Reference

yaml path / env name(s)DescriptionDefault value
log.level
LOG_LEVEL
Log level to use (info, warn or error)info
log.format
LOG_FORMAT
Format of the logs (json, console)console
data.path
DATA_PATH
Where data produced by seelf will be saved (deployment artifacts, logs, local db, …)~/.config/seelf
data.deployment_dir_template
DEPLOYMENT_DIR_TEMPLATE
Go template determining the directory where the build will occur (use {{ .Number }}-{{ .Environment }} if you want to keep all application deployment sources for example){{ .Environment }}
http.host
HTTP_HOST
Host to listen to0.0.0.0
http.port
HTTP_PORT,PORT
Port to listen to8080
http.secure
HTTP_SECURE
Wether or not the web server is served over https. If omitted, determine this information from the EXPOSED_ON variable. It controls wether or not cookie are set with the Secure flag and the scheme used on the Location header of created resourcesfalse
http.secret
HTTP_SECRET
Secret key to use when signing cookies<generated if empty>
runners.poll_interval
RUNNERS_POLL_INTERVAL
Interval at which background jobs are picked. Should be parsable by time.ParseDuration4s
runners.deployment
RUNNERS_DEPLOYMENT_COUNT
How many deployment jobs could be run simultaneously4
runners.cleanup
RUNNERS_CLEANUP_COUNT
How many cleanup jobs could be run simultaneously2
-
ADMIN_EMAIL
Email of the first user account to create (mandatory if no user account exists yet)
-
ADMIN_PASSWORD
Password of the first user account to create (mandatory if no user account exists yet)
-
EXPOSED_ON
Url at which the seelf container will be exposed and default target url. In the form <url scheme>://<container name>@<default target url>