Skip to main content

Environment Types Scenarios - local & remote

  • ENV_TYPE=local - a local workstation https://localhost:443/portal
  • ENV_TYPE=remote - a remote server with functional Fully Qualified Domain Name access with https://<FQDN>/portal

[!NOTE]

  • Remote Server requires a Fully Qualified Domain Name
  • Access Remote Server by IP address is not supported
  • Defaults are specified in the docker-compose.yml file

Variables​

CADDY__ALP__PUBLIC_FQDN - Fully Qualified Domain Name (FQDN) for TLS communication over https​

[!TIP]

  • 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 scenario - ENV_TYPE=remote​

a) 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'

b) 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=' '