Browse documentation

Organizations and namespaces

An organization is the top-level owner of Codinamo resources. It owns workspaces and provides the public namespace used by hosted Git repositories and Registry images.

Every account has a personal organization. Create an additional organization when work must belong to a company, product group, or other shared owner instead of one person.

Organization identity

Each organization has three different identifiers:

Display name

Human-readable text that can be changed later.

Namespace

Globally unique, URL-safe name used in Git and Registry paths.

Organization ID

Stable canonical identifier beginning with ORG-.

Changing the display name does not change the namespace or canonical ID. This keeps repository and image references stable.

A namespace contains lowercase letters, numbers, and internal hyphens. Choose a durable name because it represents ownership in public paths such as:

https://git.codinamo.com/acme/payments.git
registry.codinamo.com/acme/payments

Use the context switcher

The context switcher beside the Codinamo name displays the current location as:

Organization > Workspace

Select the organization itself to open organization administration. Select one of its workspaces to operate projects, pipelines, variables, secrets, runs, agents, and deployment targets.

The switcher also provides links to manage all visible organizations and workspaces.

Create an organization

  1. Open the context switcher.

  2. Select Manage organizations.

  3. Enter a display name.

  4. Optionally enter the desired namespace. If omitted, Codinamo derives one from the name.

  5. Select Create organization.

The namespace must be globally available. The creator receives the Organization Owner role on the new organization.

Create workspaces inside an organization

  1. Select the organization in the context switcher.

  2. Open Workspaces.

  3. Enter the workspace name.

  4. Select Create and open.

A workspace belongs to exactly one organization. Projects and delivery resources remain isolated inside that workspace, while organization-level teams can receive access to more than one workspace.

See Workspaces and projects for the resources owned by a workspace.

Rename an organization

Open the organization, select Settings, and change its display name. Renaming requires organization:update and does not alter its namespace.

See Teams and membership to group members and Manage access to grant roles.