Skip to main content

Organizations

An organization is an enterprise account. It is owned by one user, operated by its members, and has limits that you set. Large organizations can be split into departments, each with a share of the organization's limits.

By the end of this page you will know how to create an organization, manage its members and departments, change its owner, and retire it.

Admin Panel → Platform → Organizations (/admin/organizations)

What members see and do inside an organization is covered in the user guide under Organizations.

The organization list​

Columns: Organization, Owner, Plan, Devices, Domains, Labs, Members, Depts, Actions. Usage is shown against the limit; a limit of 0 shows as "∞/plan", meaning the plan default applies.

Each row has Manage and an archive icon.

Creating an organization​

Select Add organization. The wizard has four steps.

1. Identity​

Optional logo (up to 2 MB), Name, Slug (3 to 30 characters, used in addresses and fixed once created) and Plan (Free, Pro or Enterprise).

2. Owner​

The email of the user who will own the organization. You are recorded as the creator but are not added as a member.

3. Limits​

LimitNotes
Devices limitShown to members in their Account Limits
Domains limitShown to members in their Account Limits
Running labsShown to members in their Account Limits
ServicesPlus optional per-service caps
Storage (GB)When above 0 you also choose Enforcement (Auto, LVM volume or XFS quota) and a Storage pool, where available

0 means the plan default.

Watch usage on the organization page

The organization's detail page shows what its members are using against these limits. Review it when you change a plan or add a large group of members.

4. Review​

Check the summary and select Create organization. Creation is audited.

You can also launch the same wizard from the organizations hub on the normal dashboard.

Managing an organization​

Select Manage on a row. The dialog has four tabs.

Shown on labs.selfmade.ninja, the Selfmade Ninja Academy platform. On your own platform you will see your own domain and data.

General​

Logo (uploads immediately), Name, Plan, limits and per-service caps. The slug is read-only. Select Save changes.

Members​

Each member has a role, Member or Admin. Change it from the dropdown, remove a member (with confirmation), or Add someone by email or username.

Departments​

Organizations only. Lists the departments, each with Manage and Archive (with confirmation). Add department creates one and splits the organization's limits between departments.

Danger​

ActionWhat it doesConfirmation
Transfer ownership to + TransferMakes another user the ownerNone. Check the email first.
ArchiveHides the organization from switchers and lists. Its labs, domains and storage are kept.Yes
Teardown…Removes everything the organization holds. See below.Typed phrase

Rules for a new owner​

  • The new owner must already have an account. Enter their email or username. An address with no account is refused with "Account not found", so an organization can never be handed to someone who cannot sign in.
  • When you make someone the owner of a department, they are also added to the parent organization as a member if they were not one already.
  • The change is recorded in the audit trail with the old and the new owner.
There is no un-archive button

Once archived, an organization cannot be restored from the panel. Ask your engineering team if you archive one by mistake.

Tearing down an organization​

Teardown is how you fully retire an organization.

  1. Open Manage → Danger and select Teardown….
  2. Read the preview. It lists every category and how many items will be affected. Child departments are torn down first.
  3. Type DELETE followed by the organization's slug.
  4. Select Run teardown.

Teardown then:

  • stops every instance
  • frees VPN peers and reserved addresses
  • deletes domains
  • removes service users from managed databases
  • revokes sharing grants
  • retires storage, which stays recoverable for a grace period
  • archives the organization

Everything except storage happens immediately. If some items fail, the message says so. Run teardown again to retry the leftovers; items already done are skipped.

All organization actions on this page are audited.

Deletion requests from members

Organization members can ask for their organization to be deleted, but those requests do not appear in the admin panel in this release. If a member asks you directly, use teardown.

Next​