An organization is the top level of ORC8R. It represents your company or team and owns everything else: your projects, and the pools and nodes inside them. Everyone you work with belongs to the same organization, and the organization is where limits and membership are managed.
The big picture
ORC8R is organized in layers:
- An organization contains projects.
- A project contains pools.
- A pool contains nodes (the actual machines).
So your organization sits at the top, and everything you create lives somewhere beneath it. See Projects, Pools, and Nodes for the layers below.
Creating an organization
- Go to Orgs and click Create Organization.
- Fill in Organization Name — a human-readable name, 4 to 64 characters (for example, "Acme Ltd").
- Fill in Organization Code — a short identifier used in web addresses and API paths. It must be 4 to 20 characters, using only lowercase letters, numbers, and dashes, and it cannot start or end with a dash (for example,
acme). The code is suggested automatically from the name, but you can change it. - Click Create Organization.
The person who creates an organization automatically becomes its owner. Each organization code must be unique; if the one you chose is taken you will be asked to pick another.
Members and roles
Open an organization and click Members to see everyone in it. The list shows each person's name, email, role, and when they joined.
There are two organization roles:
| Role | What they can do |
|---|---|
| Owner | Full control of the organization: manage members, projects, apps, limits, and billing. |
| Member | Read access plus the ability to create projects, request nodes, and manage project members. Members cannot change organization limits, manage members, or manage billing. |
Adding a member
- Open your organization and click Members, then Add Member.
- Enter the person's Email address.
- Choose a Role — Owner or Member.
- Click Add Member.
The person must already have an ORC8R account with that email address. Adding a member links an existing account to your organization; it does not send an invitation to a brand-new email. If no account exists for the address, you will see a "user not found" message, and the person should sign up first.
Only owners can add, remove, or change the role of members. To keep an organization usable, ORC8R will not let you remove or demote the last owner. If you need to hand over ownership, promote another member to owner first, then step down.
Organization settings
Open an organization to see its settings. The overview shows the organization's Code and Your role. Alongside it you will find the resource limits (below) and, on the Event History tab, a log of changes made in the organization.
Limits
Limits are caps that stop an organization from creating more resources than intended. Open your organization and click Resource Limits. There are three:
- Max projects — how many projects the organization may have.
- Max pools — how many pools each project may have.
- Max nodes — how many nodes each pool may have.
For any limit, set the value to -1 to mean unlimited, or 0 to prevent creating that kind of resource at all. Only owners can change limits; members can view them but will not see the edit form.
Related pages
- Projects — the workspaces inside an organization.
- Quickstart — from sign-in to a running node.