Setup & Installation Guide

Watch the complete video walkthrough for setting up OneCamp, configuring DNS, and launching your team's unified workspace.

Required DNS Subdomains for OneCamp

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

  • traefik.yourdomain.com
  • onecamp-dgraph-alpha.yourdomain.com
  • onecamp-dgraph.yourdomain.com
  • onecamp-ch.yourdomain.com
  • onecamp-emqx.yourdomain.com
  • onecamp-emqx-console.yourdomain.com
  • onecamp-collab.yourdomain.com
  • onecamp-postgres.yourdomain.com
  • onecamp-minio.yourdomain.com
  • onecamp-minio-console.yourdomain.com
  • onecamp-redis.yourdomain.com
  • onecamp-os.yourdomain.com
  • onecamp-backend.yourdomain.com
  • onecamp-livekit.yourdomain.com

Quick copy-paste (without domain suffix)

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 (optional – for your team)

Subdomain Purpose / 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)

Authorised JS origin:

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

Authorized redirect URIs

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