Organisations
An organisation is the top-level container for everything you do on Bahriya. Projects, containers, registries, secrets, billing, and team members all belong to an organisation.
Creating an organisation
After signing in for the first time, you create an organisation to get started. Each organisation requires:
- Name — A display name (alphanumeric characters and spaces, up to 77 characters).
- Handle — A permanent, URL-friendly identifier (lowercase letters, numbers, and hyphens, up to 51 characters). Handles cannot be changed after creation.
- Email — A contact email address for the organisation.
Once created, Bahriya sets up billing for the organisation automatically.
What lives inside an organisation
| Resource | Purpose |
|---|
| Projects | Group related containers, registries, and secrets |
| Containers | Running application instances |
| Registries | Credentials for private container image registries |
| Secrets | Encrypted environment variables injected at runtime |
| Members | People with access to the organisation |
Organisation dashboard
The dashboard shows a summary of your organisation: how many projects, containers, registries, secrets, and members you have. It also shows a recent activity feed so you can see what has changed and who changed it.
Roles
Every member of an organisation has a role that controls what they can do:
| Role | What they can do |
|---|
| Owner | Full control. Can manage billing, delete the organisation, and manage all members including other owners. |
| Admin | Can manage members, create and manage projects and resources. Cannot delete the organisation. |
| Member | Can create and manage resources within projects. Cannot manage other members. |
| Viewer | Read-only access to all resources. Cannot create, update, or delete anything. |
When you create an organisation, you are automatically assigned the Owner role.
Deleting an organisation
Only an owner can delete an organisation. Deletion requires you to type the organisation name to confirm. When an organisation is deleted:
- All projects within it are deleted.
- All running containers are terminated.
- All registries, secrets, and other resources are cleaned up.
- Billing stops once all containers are terminated.
- Data is retained for audit and billing purposes but the organisation no longer appears in your account.
This action is permanent and cannot be undone.
Multiple organisations
You can belong to more than one organisation. The organisations list in the console shows every organisation you are a member of along with your role in each.
