OneCamp
The Self-Hosted Unified Workspace
Chat · Tasks · Docs · Whiteboards · Video · AI teammates. All on your own server.
Live Demo · Server (AGPL-3.0) · Free for up to 25 people · Desktop app · Docs · Report a Bug
What is OneCamp?
OneCamp is a self-hosted workspace that replaces Slack + Notion + Zoom, without per-seat pricing and without your conversations living on somebody else's machine. You run it on your own infrastructure, and the data stays there.
Open source. The whole of OneCamp is open: this web app under MIT, and the
server at OneMana-Soft/OneCamp under AGPL-3.0,
with a commercial licence for companies that cannot accept AGPL. Build it yourself, or get the
ready-made release with a one-command installer free for up to 25 people.
This README once said the AI-free server would be released under Apache-2.0 with the AI edition kept
commercial. We chose AGPL-3.0 for both editions instead, so the AI edition is open too, and AGPL keeps
anyone from taking the server private as a closed hosted service.
It also has AI teammates that live in your channels, bounded by the live permissions of the person who authorised them, running through your choice of model.
| |
|---|
| 💬 Real-time chat | Channels, DMs, threads, reactions, file sharing |
| ✅ Tasks & boards | Kanban, assignees, due dates, project tracking |
| 📝 Collaborative docs | Rich-text editing with real-time multiplayer cursors |
| 📊 Tables | Structured records with views, filters and formulas |
| 🎨 Whiteboards | Freeform drawing and diagramming alongside the docs |
| 🎥 Video meetings | HD calls, screen sharing, recording, live captions |
| 📅 Calendar | Scheduling that knows about the meetings in your channels |
| 🏢 Teams & projects | Fine-grained permissions and organised workspaces |
| 🤖 AI teammates | Agents in your channels, with tools, memory and an audit trail |
| 🔐 Enterprise sign-in | SAML, OIDC, LDAP, SCIM provisioning, MFA |
| 📱 Installable app | PWA with push notifications on desktop and mobile |
Unlimited users. One payment. Your server.
Tech Stack
This repository is the Next.js frontend. The Go backend is a separate download (see below).
Getting Started
Prerequisites
- Node.js v20.9+
pnpm (recommended)- A running OneCamp backend. The frontend is a client; on its own it has nothing to talk to.
1. Clone and install
git clone https://github.com/OneMana-Soft/OneCamp-fe.git
cd OneCamp-fe
pnpm install
Which edition you get. This is the ai branch, and it is what a clone
gives you by default. It expects a backend built with agents. If your licence
is for the edition without them, take main instead, or the interface will
offer you agents your server has no routes for:
git clone -b main https://github.com/OneMana-Soft/OneCamp-fe.git
The installer picks the right branch for your licence on its own; this note is
for anyone cloning by hand.
2. Point it at your server
pnpm configure
It asks one question, your domain, and derives every address from it. These match the hostnames the backend already requests certificates for, so a stock install needs no further edits.
On the machine running your backend:
onecamp-backend.your-domain.com the API
onecamp-livekit.your-domain.com calls and meetings
onecamp-collab.your-domain.com live document editing
onecamp-emqx.your-domain.com real-time messaging
onecamp-minio.your-domain.com file storage
onecamp-turn.your-domain.com call relay (must NOT be proxied)
Wherever you deploy this app:
onecamp.your-domain.com the workspace people open
Keep the workspace on the same parent domain as the API. Sign-in and CSRF cookies are scoped to the shared parent, so a frontend served from a different domain, a *.vercel.app address say, cannot read them. Sign-in appears to work and then every write fails. Host it wherever you like; point onecamp.your-domain.com at it.
The last two are the ones that bite. onecamp-minio is where uploads are served from, and a missing record looks like "images are broken" rather than like a DNS problem. onecamp-turn carries call media over UDP, which a CDN proxy cannot pass, so proxying it does not fail loudly: calls just do not connect for some networks.
For a scripted install, skip the prompt:
pnpm configure --domain your-domain.com
Every variable is documented in .env.production, which ships with placeholders. Three ways to supply real values, in the order Next.js prefers them:
- Environment variables. Highest precedence, and the right answer for a Docker or CI build.
.env.production.local. What pnpm configure writes. Git-ignored, so your domains never land in a commit and git pull never conflicts with your configuration..env.production. The committed reference. Editing it works, but your changes will collide the next time you pull.
Everything here is NEXT_PUBLIC_, which means it is compiled into the JavaScript the browser downloads. None of it is secret and none of it should be. Real secrets stay in the backend's own .env.
3. Build and run
pnpm build
pnpm start
Or pnpm dev for a development server on port 3001.
4. Push notifications (optional)
Off until you configure them, and they need a Firebase Cloud Messaging project of your own: the token a browser mints is only redeemable by the project that issued it, so a shared one cannot work. Copy the six web-app values plus the VAPID key into .env.production.local; .env.production lists exactly which ones and where in the Firebase console to find them.
Everything else in OneCamp works without this.
AI, on your terms
The AI is bring-your-own-key and bring-your-own-model. Point it at a local Ollama, at a self-hosted vLLM, or at a hosted API with your own key; nothing is routed through us, and there is no OneCamp inference endpoint to route it through.
Every agent action is bounded by the live permissions of the person who authorised it, and recorded before it runs. An agent cannot read a channel its principal cannot read, and revoking that person's access revokes the agent's in the same moment.
Agents are off until an admin turns them on, and each capability is granted separately.
Backend
This frontend requires the OneCamp Go backend. It ships as a single Docker Compose deployment including:
- Go services for chat, documents, tasks, calendar and meetings
- Real-time signalling and state synchronisation
- Postgres, Dgraph, Redis, MinIO and EMQX, pre-configured
- Traefik with automatic HTTPS certificates
- Enterprise sign-in: SAML, OIDC, LDAP, SCIM, MFA
- One command to install, one command to update
→ Get the backend licence at onemana.dev: pay once, unlimited users, no per-seat pricing. The current price is on that page.
Project Structure
OneCamp-fe/
├── app/ # Next.js App Router pages & layouts
├── components/ # UI components
├── context/ # React context providers
├── e2e/ # Playwright end-to-end tests
├── hooks/ # Custom React hooks
├── lib/ # Utilities, env validation, security headers
├── public/ # Static assets & the service worker
├── scripts/ # Setup and tooling
├── services/ # API service layer
├── store/ # Redux store & slices
└── types/ # TypeScript type definitions
Development
pnpm dev # dev server on :3001
pnpm lint # ESLint
pnpm test:unit # unit tests (Vitest)
pnpm test:e2e # end-to-end tests (Playwright)
CI runs lint, a production build, the unit tests and the Playwright suite on every push and pull request.
Contributing
Contributions are welcome. Please open an issue first to discuss what you would like to change.
- Fork the repository
- Create a feature branch:
git checkout -b feat/your-feature
- Commit your changes:
git commit -m 'feat: add your feature'
- Push and open a Pull Request
Run pnpm lint && pnpm test:unit before opening it; that is what CI checks first.
Support
Made with ❤️ by OneMana Soft
