Skip to content

Setup flow

OneCamp Cloud

This guide is for OneCamp Cloud subscribers. You do not install anything and
you do not need a server: one is provisioned for you, and it is yours alone.

If you bought a one-time licence instead, you want Installation.

What you get

A whole server, running only your workspace. Not a row in a shared database,
not a schema alongside other customers: your own machine, your own Postgres,
your own file storage, your own encryption keys.

That is more expensive for us and it is the point: there is no query anywhere
that has to remember to filter by your account, because there is nothing else on
the machine to filter out. It also means we cannot read your data, and cannot
restore it for you from some central backup, because there isn't one.

1. Name your workspace

After you subscribe, open your account page and
choose a name. Your workspace becomes:

yourname.onemana.dev

Pick carefully: it is the address everybody types. You can move to your own
domain later, but the name is how your team finds you in the meantime.

2. Wait for it to be built

Setting up a machine takes tens of minutes: ordering it, preparing it,
installing, issuing certificates. Your account page shows where it has got to,
and we email you when it is ready.

If it is taking unusually long, that is visible to us too and somebody is
already looking at it. You do not need to report it.

3. Sign in

The "your workspace is ready" email carries the address, your username, and a
generated password. Change that password after your first sign-in. We keep no
copy of it; that email is the only place it has ever existed.

4. Email for your team

Your "your workspace is ready" email says which of these applies.

Invitations and password resets work from the start. Your workspace sends
them from OneCamp's own mail, up to 20 a day, so the first thing you do, inviting
your team, works straight away. Notifications arrive in the app and on phones.

To have notifications emailed as well, or to send more than 20 a day, add your
own sending key in your workspace under Admin → Settings → Email. It replaces
ours, and mail then comes from your own domain.

If your ready email asks you to switch email on, it could not be switched on for
you: add a key as above. Until you do, inviting someone shows you a link to share
yourself, and "Forgot password" says "check your email" and nothing comes,
because that page gives the same answer either way by design.

5. Everything else, in your admin panel

None of it needs a config file or a server login.

  • Google / GitHub sign-in: your own OAuth client id and secret.
  • AI: on the edition with AI, your workspace starts with a model already
    running on its own machine, so AI works from the first day with no key and no
    extra bill. For a bigger model, choose a provider and paste your key; a key you
    add always takes over. We do not resell inference.
  • Upload limits, allow-lists, two-factor: all in the same panel.

Using your own domain

You can move your workspace to a domain you control. On your account page, enter
the domain and we show you the DNS record to create. Add it, then press check.

We verify the record actually resolves before switching anything over, so a
mistyped record leaves your workspace exactly where it is rather than taking it
offline.

If you are locked out

Your admin password is set once and never stored, so it cannot be looked up or
resent; a new one is the only way in. Tell us and we will issue a one-time reset
link to the address on your account. You choose the new password; we never see it.

Two things make this quicker if they are true before you need it: make sure email
is on
(step 4), so your team can reset their own passwords without us, and keep
your recovery codes
if you turn on two-factor. If both the authenticator and
the codes are gone, we can clear the second factor for you, but we will want to
be sure who we are talking to first.

Your licence key

A subscription includes the self-hosted licence too, and it is on your
account page with the command to install it.

One key covers both editions, v1 without AI and v2 with it, and the
installer asks which you want. If you ever lose it, sign in and copy it again; it
is always there.

It stays yours. Cancelling the subscription ends the hosting we run for you, not
the licence.

Updates

We update the workspace for you. You do not download anything and there is
nothing to run.

Being straight about where this stands today: updates are applied by us rather
than on a schedule you can see, and there is no page showing which version you
are on. If you want a specific fix, ask and we will tell you whether it has
reached your workspace.

More room for files

Files and recordings are what fill a machine. When your workspace needs more room than its disk, add extra storage from your account page: a fixed amount of room for a fixed monthly price, shown there and on the pricing page. It is billed monthly alongside your workspace and can be cancelled any time; it runs to the end of the paid month, and before it ends your files need to fit on the machine again. We attach it within a day of payment and your account page says when it is done. From the next day your account page shows how much of it is used, and we email you when it is nearly full; nothing is cut off if it fills. Payments are final; we do not offer refunds.

As your team grows

More people and more messages do not fill a machine evenly. Search and the message graph keep your history in memory, calls use processor while they run, and files use disk. We read your machine every day, and your account page says so when it is getting full. If it stays busy three days running we email you once, with two ways forward: archive what you no longer need (Admin, then Archive; archived items leave search, which frees memory), or a larger machine. Nothing is ever cut off for being busy, and nobody is counted at the door.

Team and Business

Cloud comes in two sizes, and the difference is the machine your workspace runs on. Team is sized for up to 30 people. Business is sized for up to 100, on a machine with much more memory and disk, for larger teams and longer history. Both are the same product with the same features; the pricing page has the current prices.

You can change size from your account page at any time:

  • Team to Business is charged now for the rest of your month, and your workspace moves to the larger machine.
  • Business to Team happens when your paid Business month ends; nothing you have paid for is taken away early. Your workspace then moves to a Team machine.
  • Monthly to yearly on Team is charged now; yearly back to monthly waits for the end of the paid year.

Some payment methods, such as UPI Autopay, cannot change a plan in place. For those the account page opens a checkout for the new plan instead, starting when it should, and the old plan ends on its own. Payments are final; we do not offer refunds.

Moving to a new machine

When your workspace changes size, or needs a larger machine, we move it for you. Your address, your data, your settings and everyone's sign-in stay the same.

  1. We prepare the new machine and install the same version on it. Your workspace keeps running throughout.
  2. We move in the quiet window, 01:30 to 05:30 India time, and email you the time first. If you would rather move now, press Move now on your account page.
  3. For the move itself the workspace is paused, usually 10 to 30 minutes: a final backup is taken, copied across, restored and checked.
  4. Then the address switches to the new machine and your team carries on. We email you when it is done. The old machine is erased and released.

If anything goes wrong before the switch, the move is undone: the old machine is started again exactly as it was, and nothing written before the pause is lost. We check against last night's backup that your files fit the new machine before anything is paused, so a move that cannot fit is called off without touching your workspace.

On your own domain, the move emails you the new address to point your records at. Until you change them the old machine passes traffic through to the new one, for up to 14 days, so nobody notices the switch.

Backups

Your workspace is backed up every night on its own machine, and the newest seven backups are kept there. They cover a bad change or a mistaken delete. They do not cover losing the machine itself.

Deleting a message or a file hides it and keeps the bytes. To make files and recordings go for good, and to get the disk space back, set Remove for good on the Attachments and Recordings policies in your admin panel, under Archive. Anything removed for good still exists in the last seven nightly backups on the machine, and is gone after that.

Cancelling

You cancel from your account page, and nothing dramatic happens immediately.

  1. Your workspace keeps running to the end of the period you have paid for.
    There are no refunds and no partial months; you simply keep what you bought.
  2. Then it becomes readable but not writable for 14 days, so you can export
    anything you want to keep.
  3. Then the machine is wiped, a real disk erase before it is released, and
    the data is gone. Not archived, not held for a while. Gone.

We email you before each of those steps. If you resubscribe during the export
window your workspace comes straight back; after the wipe it cannot.

What this does not include

Being honest about the edges:

  • No central backup. One machine per customer means there is no fleet-wide
    restore. Export what matters to you.
  • Calls need a LiveKit server, which the standard build does not run.
  • Mobile push needs Firebase credentials, which most workspaces will not have.

Anything here that you would rather run yourself, you can: every Cloud
subscription includes the self-hosted licence, and the product is the same
product. You would just be bringing the machine.