Server Configuration

This documentation explains how to configure the Atlantis server and how to deal with credentials.

Configuration for atlantis server can be specified via command line flags, environment variables or a YAML config file. Config file values are overridden by environment variables which in turn are overridden by flags.


To use a yaml config file, run atlantis with --config /path/to/config.yaml. The keys of your config file should be the same as the flag, ex.

gh-token: ...
log-level: ...

Environment Variables

All flags can be specified as environment variables. You need to convert the flag's -'s to _'s, uppercase all the letters and prefix with ATLANTIS_. For example, --gh-user can be set via the environment variable ATLANTIS_GH_USER.

To see a list of all flags and their descriptions run atlantis server --help


The flag --atlantis-url is set by the environment variable ATLANTIS_ATLANTIS_URL NOT ATLANTIS_URL.

Repo Whitelist

Atlantis requires you to specify a whitelist of repositories it will accept webhooks from via the --repo-whitelist flag.


  • Accepts a comma separated list, ex. definition1,definition2
  • Format is {hostname}/{owner}/{repo}, ex.
  • * matches any characters, ex.* will match all repos in the runatlantis organization
  • For Bitbucket Server: {hostname} is the domain without scheme and port, {owner} is the name of the project (not the key), and {repo} is the repo name


  • Whitelist myorg/repo1 and myorg/repo2 on
  • Whitelist all repos under myorg on
    • --repo-whitelist='*'
  • Whitelist all repos in my GitHub Enterprise installation
    • --repo-whitelist='*'
  • Whitelist all repositories
    • --repo-whitelist='*'