Administration

Setting OvalBee up for a team — where it runs, who can do what, and what an administrator owns.

This section is for the people who set OvalBee up and keep it running for others. If you build and run flows, you won’t need most of it. Start with Core ideas instead.

Where OvalBee runs

OptionWhat it means
OvalBee CloudWe run the platform, compute and storage. You sign in at app.ovalbee.com and create workspaces.
Your infrastructureOvalBee runs in your cloud account, your VPC or your data center, on Kubernetes or a single Docker host. Data, compute and models stay inside your perimeter.

Both run the same product. On your own infrastructure, the platform can also send node runs to a separate GPU cluster, so the control plane and the heavy compute can live in different places — see Compute.

For the private beta, installation on your infrastructure is done together with the OvalBee team. Self-hosted installation describes what’s involved, so you can prepare.

Two levels of administration

OvalBee separates the installation from the workspaces in it:

  • Instance administrators configure the installation as a whole: its public address, sign-in methods, email, storage, compute, the AI agent’s API key, user accounts and the audit log. They find all of it under Admin → Configuration in the main sidebar. On OvalBee Cloud, this level is ours.
  • Workspace owners and admins run a workspace: its members and their roles, its secrets and API tokens, and on Cloud its billing. They find it under Settings.

A workspace is where the work lives: flows, datasets, models, ontologies, secrets and members all belong to one. People can be members of several workspaces and switch between them with the selector at the top of the sidebar, where workspaces are called spaces.

Setting up a new installation

A short checklist for the first day:

1

Set the public address

Under Admin → Configuration → General, set Public URL to the address people use. Links in emails, the sign-in callback of your identity provider and the address agents connect to are all built from it.

2

Connect email

Under Email, configure SMTP. Invitations and password resets are sent by email, so inviting people needs it.

3

Connect sign-in

Under Authentication, add your identity provider, so people sign in with their company account. See Sign-in and accounts.

4

Check compute and storage

Under Executor and Storage, confirm where node runs go and where files are kept, and that a GPU machine class exists for training. See Compute.

5

Enable the AI agent

Under Integrations, add an OpenAI API key to turn on AI Chat in the flow editor.

6

Invite the team

Create workspaces for your teams and add members with the right roles. See Members and roles.

Plans

A few features depend on your OvalBee plan — roles and per-flow sharing, live flow collaboration and the audit log among them. Where a feature isn’t part of your plan, the app shows it locked rather than hiding it. Your OvalBee contact can tell you what your beta setup includes.

In this section