Docker Compose

Deploy Terrateam with Docker Compose

Prerequisites

• 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

cd terrateam

2. Save your private Terrateam GitHub application settings file to .env in your terrateam/ directory next to docker-compose.yml

josh@elmer:~ $ tree terrateam/
terrateam/
├── docker-compose.yml
├── .env
└── README.md
 
0 directories, 3 files
josh@elmer:~ $

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

GITHUB_APP_ID=""
GITHUB_APP_PEM=""
GITHUB_WEBHOOK_SECRET=""
GITHUB_APP_CLIENT_ID=""
GITHUB_APP_CLIENT_SECRET=""

Start Terrateam

Start the Terratem server, PostgreSQL database, and Ngrok.

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)

Install

Navigate to your private Terrateam GitHub application URL and Install

Next steps

Complete the Terrateam Self-Hosted Next Steps