Documentation › Configure

Organizations: teams and shared billing

A company workspace: several people share projects, servers and billing, each with a role.

Everything you buy belongs to your personal workspace until you create an organization. An organization is a shared workspace for a company: its projects, servers and plans are managed by several people, and it pays with its own billing account and billing details (legal name, TRN, address) on the invoices.

Create one and switch

Create it Open the workspace switcher at the top of the sidebar and choose Create organization . You can start from your own billing details: they are copied, your personal workspace keeps its own.

Invite your team With the organization selected, open Organization in the sidebar (or Organization settings in the switcher), then choose Invite people , an email and a role. The invitation is a link that works once and expires after 7 days, for an existing account (sign in and accept) or a new one (sign up from the link). Creating an organization or inviting needs a confirmed email address; each person can send 20 invitations an hour and 50 a day, and one address receives at most 3 a day. The organization's name is plain text: letters, digits, spaces and basic punctuation, up to 60 characters, with no web or email address.

Switch The switcher shows Personal and every organization you belong to. Projects, My servers and Billing show the chosen workspace's items only; Knova Cloud remembers your choice on this browser.

Roles

Owner Everything, including members, billing, moving personal items in and deleting the organization. There is always at least one owner.

Admin Members and invitations, every project and server (admin of each project), and billing.

Billing The Billing page only: plans, Server Pro, installs, invoices, payment methods and billing details. No project access.

Member Only the projects an owner or admin adds them to, with the project role they are given (admin, tester or developer).

Paying as the organization

A hosting plan, Server Pro or an Odoo install bought while the organization is the current workspace is paid by the organization's own Stripe customer, with its billing details on the tax invoice.

Manage billing on the Billing page opens the organization's billing portal (payment methods, invoices, cancellations).

VAT works as for personal plans. A coupon issued to an email works in the organization's checkout when that email belongs to one of its owners or billing members.

Free trials, when your platform offers them: one per organization and one per person. No trial when the organization already had one or already pays for a hosting plan, nor when the person ordering already started one (personally or for another organization).

Alerts

The organization's alerts reach its owners and admins, not only the person who bought or linked something: production downtime, failed builds, backups and restore tests, linked servers going down and coming back, and Odoo installs finishing or failing. Payment alerts (a failed payment, a plan that ends, a renewal) also reach its billing members. Each person is told once, even when they are also the buyer.

Turn them off for yourself with Your alerts in Organization settings . The projects you were added to still notify you as their member.

Phone and desktop notifications follow your choices in Profile → Notifications , as for your personal items.

The command line and access tokens

kv workspaces lists your workspaces; kv workspaces use acme makes one the default of your kv profile, --workspace acme (or KV_WORKSPACE ) picks one for a single command. kv projects , kv servers and kv installs then list that workspace's items. See Command-line tool .

An access token can be limited to one organization ( Profile → Access tokens → Workspace ): it then always works in that organization and reaches only its projects. A good fit for a team's CI.

Moving personal projects, servers or plans in

Owners can move one of their personal projects, servers or hosting plans into the organization from Organization settings → Move personal items in . It belongs to the organization at once. Stripe can't move a subscription to another customer, so its current subscription keeps being charged to your own payment method until it ends; renew it from the organization's workspace and the organization pays from then on.

Leaving and removing

Removing someone (or leaving) removes their access to the organization's projects. Their personal projects, servers and plans stay theirs.

The last owner can't leave or be demoted: make someone else an owner first, or delete the organization.

An organization can be deleted once nothing is billed and it has no projects, servers, server waiting for its payment or Odoo install in progress left. The Delete organization card lists what is left, each with a link to sort it out.

Partners: an organization can be a partner's client like any account; the partner's access and the organization's members are independent. A partner creating a project for you can put it in an organization where you are an owner or admin (a plan of that organization always puts it there).

Platform support: a platform admin can open your organization read-only to help you, under a banner that says so; each visit is recorded in the platform's audit trail.