Skip to content

Docker Compose

Deploy Terrateam with Docker Compose


  • Completed Step 1
  • A private Terrateam GitHub application
  • The Terrateam GitHub application settings file
  • Docker
  • Docker Compose

GitHub application settings environment file

  1. Navigate to your cloned terrateamio/terrateam repo directory
Terminal window
cd terrateam
  1. Save your private Terrateam GitHub application settings file to .env in your terrateam/ directory next to docker-compose.yml
Terminal window
josh@elmer:~ $ tree terrateam/
├── docker-compose.yml
├── .env
0 directories, 3 files
josh@elmer:~ $

Your .env file should look like this (but with actual values):


Start Terrateam

Start the Terratem server, PostgreSQL database, and Ngrok.

Terminal window
docker-compose up server -d

Wait for docker-compose to return

GitHub application webhook URL

When the Terrateam server starts up, it will try to update the GitHub application Webhook URL if the following are true:

  • The TERRAT_API_BASE environment variable is unset
  • The NGROK_ENDPOINT environment variable is set
  • The GITHUB_WEBHOOK_URL_UPDATE is set to TRUE (default is TRUE)


Navigate to your private Terrateam GitHub application URL and Install

Next steps

Complete the Terrateam Self-Hosted Next Steps

We use cookies and similar technologies to provide certain features, enhance the user experience and deliver content that is relevant to your interests. Depending on their purpose, analysis and marketing cookies may be used in addition to technically necessary cookies. By clicking on "Agree and continue", you declare your consent to the use of the aforementioned cookies. Here you can make detailed settings or revoke your consent (in part if necessary) with effect for the future. For further information, please refer to our Privacy Policy .