Managing Authgate with Docker Compose

Authgate’s deployment is based on Docker Compose. So to monitor and manage Authgate, you need to use Docker Compose commands.

All docker compose commands must be run from the docker/ folder:

cd docker
docker compose <command>

Useful Commands

View logs:

docker compose logs -f

Restart Authgate:

docker compose restart

Stop Authgate:

docker compose down

Manual Installation with Docker Compose

This guide is for setting up Authgate manually if you want to do it yourself.

When to Use This

Use manual installation if:

• You’re not running Debian 12
• You know how to use Docker and Docker Compose

For most users: I recommend using the setup script instead - it’s much easier.

What You Need

• Docker and Docker Compose installed on your server
• A domain name pointing to your server
• An SSL certificate for your domain

Installation Steps

1. Copy the example configuration file:

cd docker
cp env.example .env

2. Edit the .env file with your settings:

   • Change all passwords (look for “change-this”)
   • Set your domain name
   • Set your admin username and password
   • Optionally set HTTP_PORT and HTTPS_PORT if ports 80/443 are already in use

3. Put your SSL certificate files in the docker/ssl/ folder:

   • certificate.crt (your certificate)
   • certificate.key (your private key)

4. Start Authgate:

docker compose build
docker compose up -d

Visit your domain to access Authgate and log in with your admin credentials.

For updates, use the update script instead of manually updating.