Configure TLS

Add TLS/HTTPS configuration to your project for secure domain access to:

• Expose your TEE app using HTTPS.
• Receive webhook events over HTTPS.
• Serve web UIs securely.
• Deploy to production with TLS.

EigenCompute enables TLS with Let's Encrypt using Caddyfile. To use an alternative certificate provider, configure in your Dockerfile.

TLS Environment Variables

Variable	Description	Required	Default
DOMAIN	Your domain name	Yes	-
APP_PORT	Port your app listens on	Yes	-
ACME_STAGING	Use Let's Encrypt staging	No	false
ACME_FORCE_ISSUE	Force certificate reissue	No	false
ENABLE_CADDY_LOGS	Enable Caddy debug logs	No	false

Configure TLS and Test with Staging Certificates

1. Add TLS environment variables as prompted, or provide using --domain, --app-port, --acme-staging, and --caddy-logs options.

   The TLS variables are appended to your .env file, and TLS placeholders are appended to .env.example.

   tip

   To avoid Let's Encrypt rate limits, always test with staging certificates first.

2. Configure DNS by creating an A record pointing to your instance IP:

   • Type: A
   • Name: yourdomain.com
   • Value: Obtain IP address from ecloud compute app info

3. Deploy app with TLS configuration:

   ecloud compute app upgrade  

   The configured TLS routes traffic from ports 80 and 443 to the APP_PORT.

Switch to Production Certificates

To switch from staging to production:

1. Force a reissue of certificates by updating the ACME_FORCE_ISSUE environment variable:

ACME_STAGING=false
ACME_FORCE_ISSUE=true  # Only needed once

2. Redeploy the app:

ecloud compute app upgrade

3. Disable the ACME_FORCE_ISSUE environment variable:

ACME_FORCE_ISSUE=false

Let's Encrypt Rate Limits

Let's Encrypt has a rate limit of 5 certificates per week per domain. Always test with staging certificates first.

Upgrading

You can update DOMAIN and APP_PORT in the environment file and upgrade without rebuilding the Docker image. If you change anything else in the Caddyfile itself, you must rebuild the image because the Caddyfile is embedded at build time.

Troubleshooting

DNS not propagating

Wait 5-10 minutes after DNS changes. Verify with:

dig yourdomain.com
nslookup yourdomain.com

Certificate issuance failing

Check logs:

ecloud compute app logs

Common issues:

• DNS not pointing to correct IP.
• Port 80/443 not accessible.
• Domain already has certificates (use ACME_FORCE_ISSUE=true).

Rate limit exceeded

If you hit rate limits:

• Wait a week for the limit to reset.
• Use a different subdomain.
• Consider using staging for development.