Skip to main content
An organisation is your team’s account in Ankra. It holds the clusters, the people who can reach them and what each person may do, and the credentials and variables every cluster shares. If you work for more than one team or customer, each gets its own organisation, and you switch between them. Inside one organisation, projects divide the clusters and applications into rooms that a member can be limited to, while people, roles and billing stay organisation-wide. How Ankra Works shows where the organisation sits in the overall model.

Where the Organisation Lives in the Portal

The organisation picker at the top of the side menu shows which organisation you are in. It also holds Organisation settings, Manage organisations and New organisation. The organisation’s own pages are spread over the side menu by what they are for. Settings holds the organisation’s name and logo, leaving or deleting it, and Plan and billing. Identity & access holds People, Roles, Projects, Sign-in and security, API and automation, Ankra support access and the Audit log. The shared configuration every cluster uses sits beside what it configures: Infrastructure has Variables and secrets, Domains and Backups and storage, and Build & delivery has Builds and clusters, Registries and Helm registries.

Switching and Creating Organisations

Each organisation has its own clusters, Stacks, applications and credentials, and you see only those of the organisation you are in. Manage organisations in the picker opens Your account → Organisations, which lists every organisation you belong to with your role in each, a search box, and a Switch button per organisation. Invitations waiting for you are on Your account → Invitations, where you join or decline each one. New organisation, in the picker or on that page, opens Create an organisation. You become its owner and Ankra opens it; your other organisations stay as they are, and you can switch back at any time. Two limits apply to creating one:
  • An address on a temporary-mailbox domain cannot create an organisation. Ankra refuses with: Sign up with a work or personal email address; temporary email addresses can't be used. If you signed in with this address before and want your account back, contact [email protected] and we will transfer the organisation to you.
  • The number of organisations one person may own is capped, and accounts whose addresses reach the same mailbox count as one person. Beyond the cap Ankra refuses with This account cannot create another organisation. An owner can ask for a higher limit from the billing settings of an organisation they own, or contact [email protected].
Joining an organisation you were invited to is never held back by either limit.

Inviting People

Identity & access → People lists the organisation’s Members and its pending Invitations. Invite people opens Invite people to <organisation>: paste one or more email addresses, separated by commas or new lines (up to 20 at a time), and choose the role they join as once for all of them. Each person gets an email with a link to join, and the dialog then says what happened to each address, for example Already in or invited or Not sent. Project only is the role for someone who should reach only the projects you choose and nothing organisation-wide; give them a role in each of those projects afterwards.

Managing Users & Roles

Ankra has five built-in roles - Owner, Admin, Operator, Member and Viewer - plus custom roles you define, and each can be assigned to the whole organisation, one cluster, a cluster group, or one project. See Roles & Access for what each role grants and how to assign one. Each member’s row on People has a menu, starting with Open their page, where their role and access are changed or removed.

Projects

A project is a room inside the organisation: every cluster and application belongs to exactly one, a member can be limited to one project, and cost is reported per project. Credentials, registries, backup vaults, object storage buckets, variables, notification routes and DNS zones are either in a project or organisation-wide. Every organisation has a Default project that holds everything you had before projects arrived, so nothing changes until you create a second project. The invoice, the members and the roles never split. Projects has the model, how your current project is chosen, project-only members, and how resources move between projects.

Organisation Variables

Variables set on the organisation apply to every cluster and Stack in it, and a cluster or Stack variable of the same name overrides them. Where to set them and how precedence works is on the Variables page.

Next

Ankra Agent explains how a cluster connects to your organisation.