Skip to main content

Organizations and Projects

Organization and project are core concepts that apply across all Nine products and APIs, not just a single one. Whether you are deploying an application with Deploio, creating an on-demand database, setting up a Managed Kubernetes cluster, or managing object storage, your resources are always scoped by an organization and a project.

Organizations​

An organization represents your company or account on Nine. It is the top-level container for everything you create: every resource you own belongs to exactly one organization. Organization names are unique across all of Nine.

When your organization is created, Nine automatically sets up its root project for you.

Projects​

A project is a way to logically separate your resources into different units, for example to split development, staging, and production environments, or to group resources by team. You are free to create as many projects as you need.

Project names must be prefixed with your organization's name. For example, an organization named acme could create a project named acme-dev.

Projects exist side by side and cannot be nested inside one another.

The Root Project​

Every organization automatically gets one special project, the root project, created at the same time as the organization itself. The root project always has the same name as the organization and cannot be renamed or deleted.

If you have not created any additional projects yet, the root project is where your resources are created by default. The root project is also the only place where you can create an API service account with organization-wide access.

You may also see the root project referred to as the "default project" or "main project" in some places; these all refer to the same concept.

Relationship Between Organizations and Projects​

An organization always has exactly one root project plus any number of additional projects you create. The hierarchy looks like this:

  • Organization
    • Root Project (created automatically, named like the organization)
    • Project (optional, named <organization>-<name>)
    • Project (optional, named <organization>-<name>)
    • ...

Working with Organizations and Projects​

You can view your organizations and projects under the Projects tab in Cockpit.