Skip to main content

Environment types

  • ENV_TYPE=local - a local workstation https://localhost:443/portal
  • ENV_TYPE=remote - a remote server with functional Fully Qualified Domain Name (FQDN) access with https://<FQDN>/portal
note
  • Remote Server requires a FQDN
  • Access Remote Server by IP address is not supported
  • Defaults are specified in the docker-compose.yml file

Variables

CADDY__ALP__PUBLIC_FQDN - FQDN for TLS communication over https

tip

Use hostname --fqdn - command on a Linux server to output FQDN

TLS__CADDY_DIRECTIVE - governs certificate creation

  • tls internal (default) - caddy will generate a self-signed certificate with internal Certificate Authority
  • ***blank*** - caddy will generate with a publicly trusted certificate using Let's Encrypt
  • For further information: https://caddyserver.com/docs/caddyfile/directives/tls

Scenarios

Local Workstation - ENV_TYPE=local (default)

export CADDY__ALP__PUBLIC_FQDN=localhost:443
export TLS__CADDY_DIRECTIVE='tls internal'

Remote Virtual Machine Server - ENV_TYPE=remote

Internal FQDN

  • Corporate DNS resolvable FQDN
  • Caddy will generate a self-signed certificate with Internal Certificate Authority
export CADDY__ALP__PUBLIC_FQDN=<FQDN>
export TLS__CADDY_DIRECTIVE='tls internal'

Public FQDN

  • Public internet resolvable FQDN
  • Caddy will generate with a publicly trusted certificate using Let's Encrypt
export CADDY__ALP__PUBLIC_FQDN=<FQDN>
export TLS__CADDY_DIRECTIVE=' '