caddy.md

Caddy

Table of contents

• What is Caddy
  • Caddyfile
• Caddy in this project
  • Caddyfile in this project
  • Caddy serves frontend files
  • Caddy forwards requests to backend
  • <caddy-port>

What is Caddy

Caddy is an open-source web server and reverse proxy.

Caddy is configured via a Caddyfile.

See Caddy in this project.

Docs:

• Caddy

Caddyfile

A Caddyfile is Caddy's configuration file. It defines which port Caddy listens on and where to forward requests.

Docs:

• Caddyfile concepts
• Environment variables in Caddyfile

Caddy in this project

Caddyfile in this project

In this project, the Caddyfile is at caddy/Caddyfile.

This configuration:

• Reads the value of CADDY_CONTAINER_PORT in .env.docker.secret.
• Makes Caddy listen on the port listen on this port inside a Docker container.
• Serves frontend files
• Forwards requests to backend

Caddy serves frontend files

Caddy serves static front-end files from /srv for all other paths. The try_files directive falls back to index.html for client-side routing.

Caddy forwards requests to backend

Caddy routes API endpoints (/items*, /learners*, /interactions*, /docs*, /openapi.json) to the app service.

<caddy-port>

The port number (without < and >) which Caddy listens on.

The port number is the value of CADDY_HOST_PORT in .env.docker.secret.

Example: 42000.