Skip to main content
An organisation’s settings are spread over the areas of the sidebar, each next to the work it governs. Settings itself holds two pages: Organisation (name, logo, short name, leave or delete) and Plan and billing. This page lists where every other setting lives, then describes the Organisation page and the few organisation-wide settings that used to sit beside it.

Where each setting lives

The sidebar’s Settings and help group holds Identity & access, Settings and Support. Infrastructure, Build & delivery, Integrations & alerts and Ankra AI sit in the Platform group above it. In Infrastructure, Build & delivery and Integrations & alerts the settings pages are listed under Configuration in the area’s menu. Your own settings (profile, your sign-in, connected accounts, notifications, API access) are not organisation settings. Open them from the account menu: see Your account.

The Organisation page

Open Settings → Organisation (/next/organisation). The page has two sections, About and Leave or delete. Owners and admins can change it. Anyone else sees the same page read-only, with a line that names their role and the people who can change it.

Rename the organisation

1

Edit the name

In About, type the new name in Name (up to 100 characters). Save name and Undo appear once the name differs from the saved one.
2

Save it

Click Save name. The page reads Saved. Everyone sees <new name> from now on., and the organisation switcher shows the new name.
The name is what everyone in the organisation sees in the switcher, on invitations and on invoices. Click Change logo…, then drop an image on Drop an image here: PNG, JPEG or WebP, up to 512 KiB and 1024 by 1024 pixels. It is uploaded the moment you choose it, and the dialog reads Saved. Everyone in <organisation> sees the new logo. Remove logo puts the organisation’s initials back. The logo shows in the organisation switcher and on these settings, for everyone in the organisation.

Short name and organisation ID

Short name is the organisation’s fixed identifier for scripts. It never changes when you rename the organisation, so commands that use it keep working. The page shows the command that switches the CLI to this organisation:
ankra org switch also takes the organisation’s name or ID, and ankra org current shows which organisation the CLI is using. The Organisation ID is under Technical details, which shows once you turn on Show technical details in the account menu.

Leave or delete

Leave <organisation> takes only you out: you lose access at once and your tokens for the organisation stop working. The only owner cannot leave until they make someone else an owner. Delete <organisation> is for owners only (admins see an Owners only badge) and is refused while the organisation still has clusters, other members or unpaid invoices. The steps, the refusals and what deleting removes are in Leave or delete an organisation.

Cluster agent upgrades

Whether Ankra upgrades every cluster’s agent on its own is set in Build & delivery → Builds and clusters, section Cluster agents.
1

Open the section

Go to Build & delivery → Builds and clusters (/next/organisation/pipelines) and scroll to Cluster agents.
2

Turn the switch on or off

Turn Upgrade cluster agents automatically on or off. On, the page reads Saved. Each cluster’s agent upgrades on its own when a new version is out. Off, it reads Saved. Each cluster shows when a new agent is out, and you upgrade it from there.
When the switch is on, Ankra upgrades the agent on every cluster a few at a time, unless a cluster’s own settings say not to: see Cluster settings. Upgrading the agent does not change your apps. Without permission to change the setting you see its state as On or Off.

DNS records

Infrastructure → Domains (/next/organisation/domains) holds the names your apps answer on. Two of its sections are organisation-wide settings.

Records on your Ankra domain

The section <organisation>’s Ankra domain shows the domain Ankra made for the organisation and the records you added under it. Ankra makes the domain when the organisation’s first cluster gets a name; until then the section reads No Ankra domain yet. Owners and admins see Add record once the domain is Active.
1

Add a record

Click Add record. Fill in Name (the label, for example logs; the domain is added after it), Type (CNAME, A or TXT), Value and Time to live (Auto, 1 minute, 5 minutes, 30 minutes or 1 hour), then click Add record.
2

Wait for it to go live

The record shows Being set up, then Active once it answers in DNS. A record Ankra could not write shows Failed with Ankra could not write it. Change it, or delete it and add it again.
3

Change or delete a record

Open the record’s options menu. Change… edits its value and time to live. Delete… asks Delete <name>?; Delete record stops the name answering within a few minutes. To change a record’s name or type, delete it and add it again.
The CLI manages the same records, and also takes AAAA records:

Cluster domains

The section Cluster names on the same page has one switch per cluster. On, the cluster gets its own name under the organisation’s Ankra domain, and its apps answer on addresses under it. Turning a switch off asks Take <cluster>’s name away?: apps on that name stop answering within a few minutes, and your own domains on the cluster keep working. Confirm with Take the name away. A cluster whose name could not be set up offers Try again.
To serve apps on a domain you own, from Add your own domain on the same page, follow Use your own domain. For a domain held in Avura, see Use Avura domains with Ankra.

Projects

When projects are turned on for your organisation, Identity & access → Projects lists them, the Default project first. Members whose role holds projects.manage (owners and admins) create, rename and delete projects there; everyone else sees the list read-only. A project that still holds resources cannot be deleted: the page names what it holds, and you move those to another project or make them available to the whole organisation first. To limit someone to one project, give them the Project only role on Identity & access → People: see Project-only members and Set up projects.

Ankra AI settings

Ankra AI’s settings are in the Ankra AI area, under Configuration: Models and provider, Skills and tools, Autonomy and approvals, AI workspaces, Memory, Feedback and Gateway connections. See Ankra AI for what each one controls.

Organisations

Members, roles and how an organisation holds your clusters.

Variables

Organisation-wide variables for use in Stacks.

Cluster settings

Settings for one cluster, including its agent.

Leave or delete an organisation

Who may delete, what must go first, and what is kept.