Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Ca
Self-host Campfire
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
Basecamp's group chat, released as open source under its ONCE line. It gives you multiple rooms with access controls, direct messages, file attachments with previews, search, @mentions, Web Push notifications and a bot API. One Docker image holds the Rails app, background jobs, Redis and file serving, and keeps all state in a single volume.
Pick Campfire when you want simple group chat for a team or family and would rather run one container than a stack. It is Basecamp's chat product released as MIT-licensed open source, with rooms and access controls, direct messages, file attachments with previews, search, @mentions, Web Push and a bot API. The snippet pins `ghcr.io/basecamp/once-campfire:1.5.8`, released 2026-11-06, adapted from the Compose example in `docs/self-hosting.md`, with secrets from the image's own generator. The Rails app, background jobs, Redis and file serving all run inside that one image and keep their state in a single volume. Upstream gives no RAM minimum, so our 512 MB floor is an estimate. Mattermost, Zulip and Rocket.Chat in this catalog add integrations, threading models, clustering and compliance features, and Synapse, Tuwunel and Tinode are separate chat protocols. Campfire stays deliberately small and is single-tenant, so pick it when a handful of rooms and a bot API are the whole requirement.
What you need
Any VPS with at least 512 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# Campfire — group chat — adapted from docs/self-hosting.md (docker compose example, secrets from the image's generator), pinned to 1.5.8mkdir campfire && cd campfiredocker run --rm ghcr.io/basecamp/once-campfire:1.5.8 script/admin/generate-secrets > .envecho DISABLE_SSL=true >> .envcat > docker-compose.yml <<'EOF'services: web: image: ghcr.io/basecamp/once-campfire:1.5.8 restart: unless-stopped ports: - "8085:80" env_file: .env volumes: - campfire:/rails/storagevolumes: campfire:EOFdocker compose up -dtimeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:8085/up; do sleep 3; done'# → http://SERVER_IP:8085 (the first visit starts a wizard that creates the admin account; DISABLE_SSL=true means plain HTTP, so put a TLS reverse proxy in front or set TLS_DOMAIN on ports 80 and 443 for built-in Let's Encrypt)
Campfire's self-hosting guide is short, and these are the points it makes:
non-negotiableCampfire is single-tenant: any room marked "public" is visible to every user on the instance, and separate groups of customers need separate deployments.
non-negotiableThe admin email you enter in the first-run wizard is shown on the sign-in page so people know whom to contact; use a throwaway address if that bothers you. Our snippet binds plain HTTP with DISABLE_SSL=true; for HTTPS either set TLS_DOMAIN and publish 80 and 443 for built-in Let's Encrypt, or terminate TLS in a proxy.
non-negotiableKeep the generated SECRET_KEY_BASE and VAPID keys. The guide says changing them later invalidates sessions and push subscriptions, so they live in .env and belong in your backups.
non-negotiableThe SQLite database must not be copied while the app runs. Run script/admin/prepare-backup in the container first, then archive the /rails/storage volume.
non-negotiableReleases are cut for every patch, and the project's notes say v1.5.7 was yanked after being built from the wrong commit. Pin an exact tag, as we do, and upgrade by pulling a newer one.
Campfire used 345 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 512 MB.
Is the Campfire install snippet verified?
The Campfire install snippet is marked verified on Ubuntu 26.04 (Nov 2026).