Skip to content
Documentation

Setup & installation

Deploy OneCamp on any Docker-capable server. Configure DNS, run the install commands, and invite your team.

Video guide

Watch the complete walkthrough for setting up OneCamp, configuring DNS, and launching your workspace.

Required DNS subdomains

Add the following subdomains to your DNS records. They should usually be A records pointing to your server IP, depending on your infrastructure.

subdomains (append .yourdomain.com)
traefik
onecamp-dgraph-alpha
onecamp-dgraph
onecamp-ch
onecamp-emqx
onecamp-emqx-console
onecamp-collab
onecamp-postgres
onecamp-minio
onecamp-minio-console
onecamp-redis
onecamp-os
onecamp-backend
onecamp-livekit

Service reference

SubdomainPurpose / service
traefikTraefik dashboard & API (protected)
onecamp-dgraph-alphaDgraph Alpha (internal)
onecamp-dgraphDgraph main endpoint
onecamp-chClickHouse
onecamp-emqxEMQX MQTT broker
onecamp-emqx-consoleEMQX dashboard
onecamp-collabCollaboration service
onecamp-postgresPostgreSQL
onecamp-minioMinIO object storage
onecamp-minio-consoleMinIO console
onecamp-redisRedis
onecamp-osOpenSearch / Elasticsearch
onecamp-backendMain application backend API
onecamp-livekitLiveKit (WebRTC video & audio)

Run these commands in sequence

Terminal setup commands
cp ./.sample.env ./.env
cp ./sample-compose.yml ./compose.yml
make update-admin-email EMAIL=your-email
make update-server-ip
make replace-domain DOMAIN=your-domain
make create-traefik-password PASSWORD=secret
make update-traefik-email EMAIL=your-email
make update-allowed-domains DOMAINS=your-domain
make create-swap
make build_restart_all
make create_postgres_db
echo "127.0.0.1 onecamp-postgres.your-domain.com" | sudo tee -a /etc/hosts
ln -s /root/.cargo/bin/sqlx /usr/local/bin/sqlx
make migrate_up

OAuth callback URLs

Replace yourDomain.com with your domain.

Authorised JavaScript origins

  • https://onecamp-backend.yourDomain.com
  • https://onecamp.yourDomain.com

Authorised redirect URIs

  • https://onecamp-backend.yourDomain.com/oauth_callback/google
  • https://onecamp-backend.yourDomain.com

Already purchased? Install with your key: get a license or read the email we sent you.

install on your server
/bin/bash -c "$(curl -fsSL https://backend.onemana.dev/onecamp/download/YOUR-LICENSE-KEY)"