Self-host Sommelier

Run the homepage, Excel TaskPane and encrypted relay on your own server and domain. Your agent stays on your machine; the relay forwards encrypted traffic between it and Excel.

What you need

A Linux server with Docker Engine and Docker Compose, plus a domain pointing to it. The included Caddy service manages HTTPS. Allow inbound TCP ports 80 and 443, and UDP 443 for HTTP/3; keep SSH available for administration.

Start your instance

Clone the repository on your server and create its deployment configuration:

git clone https://github.com/lucamattiazzi/sommelier.git
cd sommelier/deploy/sommelier
cp .env.example .env

In .env, set SOMMELIER_DOMAIN to your domain, for example sommelier.example.com. Then start the services:

docker compose up --build -d
docker compose ps

Open your domain to check the homepage. Download its Excel manifest using Download Excel add-in, then follow the setup guide to pair your agent.

Already running a reverse proxy?

Use compose.external-caddy.yaml to join your existing Caddy network without starting a second proxy. The deployment guide on GitHub includes the configuration and commands.

Updates and configuration

The manifest uses the domain selected at build time. If you change domains, rebuild the image, install the new manifest and pair again. Keep agent credentials and connection keys on the endpoints.

For registry images, updates and the complete configuration, read the full self-hosting guide.