Domain and SSL Setup

Authgate requires a domain name and SSL certificate to run securely.

Domain Requirements

You need a domain (or subdomain) that points to your server’s IP address. For example:

• auth.yourproject.com
• yourproject.com

Before installing Authgate, set up an A record in your domain’s DNS settings:

Type: A
Name: auth (or your chosen subdomain) or @ (for root domain yourproject.com)
Value: Your server's IP address
TTL: 3600 (or automatic)

Wait a few minutes for DNS to propagate. You can check if it’s working by pinging your domain:

ping auth.yourproject.com

SSL Certificates

Automatic Setup (Recommended)

If you use the setup script, SSL certificates are generated automatically using Let’s Encrypt. The script will:

1. Ask for your email address (for certificate renewal notifications)
2. Generate a free SSL certificate for your domain
3. Install it in the correct location

No additional configuration needed!

Manual Setup

If you’re doing a manual installation, you need to provide your own SSL certificates.

Place these two files in the docker/ssl/ folder:

• certificate.crt - Your SSL certificate (full chain)
• certificate.key - Your private key