Skip to content

Docker Compose setup

Use the included compose.yaml and .env.example, either from a release archive or a checkout:

Terminal window
git clone https://github.com/dougmaitelli/Campfire.git
cd Campfire
cp .env.example .env

Edit .env and set your panel’s public URL:

CAMPFIRE_PUBLIC_URL=https://panel.example.com

Networking

Configure an HTTPS reverse proxy for your panel hostname, forwarding to http://127.0.0.1:8080. The supplied Compose file binds the browser port to loopback and separately publishes the Spark TLS listener on port 8443. Configure the HTTP proxy to stream console responses without buffering.

The panel generates and persists its Spark TLS certificates automatically. By default, agents connect to the panel hostname on port 8443; set CAMPFIRE_AGENT_PUBLIC_URL if they need a different hostname or external port. This listener needs direct TLS or TCP passthrough because Spark connections use client certificates.

Start the panel

Terminal window
docker compose pull
docker compose up -d
docker compose logs campfire

Open your configured HTTPS URL. On first startup, the logs contain a one-time administrator setup token. Enter it in the setup form, choose a username, and create a password of at least 15 characters. Restarting before setup completes generates a new token; use the latest startup output.

The default setup uses SQLite and the container image’s built-in settings. For OIDC, S3 backups, SFTP, or other customizations, add optional Compose settings to the service’s environment.

To supply your own agent certificate, set CAMPFIRE_TLS_DIR to a directory containing panel.crt and panel.key, readable by container UID/GID 10001. Start Compose with -f compose.yaml -f compose.agent-tls.yaml. Preserve the certificate authority trusted by enrolled Sparks when changing TLS settings.

Continue with adding a Spark and creating your first server.