Skip to main content

Creating an Organization

Your organization is where everything in Gallium lives. Before you can deploy a virtual machine, build a cluster, or invite a teammate, you need an organization to hold it all. This page explains what an organization is, how a brand-new user signs up for one, and how service providers create child organizations for their customers.

What is an Organization?​

An organization is the top-level container (the tenant, or account) for everything you do in Gallium. It owns all of your resources, including your deployments, virtual machines, and clusters, along with your members and settings. If you are looking for where a resource belongs, the answer is always an organization.

Every organization is identified two ways:

  • Display name: the friendly, human-readable name you see across the Console. You can change this later in your settings.
  • Short Name: an immutable slug that forms the first segment of every Console URL. It is the organization's true identifier and cannot be changed once it is set.

Each organization runs under a single license program, which determines the features and capacity available to you.

Organizations can also form parent and child hierarchies, which service providers use to manage customers. It helps to keep the terms straight:

  • Organization: the top-level tenant that owns your resources, members, and settings.
  • Child organization: an organization nested under a parent, typically created by a service provider on behalf of a customer.
  • Deployments, VMs, clusters, and users: resources and members that live inside an organization, not organizations themselves.

Signing Up for a New Organization​

If you are completely new to Gallium, you create your organization and your own user account together in a single step. There is no separate account to set up first. Signing up gives you both.

To sign up for a new organization:

  1. Open the Gallium Console sign-up page, titled Create New Gallium Organization with the subheading Get started for free.
  2. Fill in Your Name and your Email address.
  3. Choose a Password for your account.
  4. Enter Your Organization: the display name for your new organization.
  5. Enter an Organization Short Name: the slug used in your Console URLs (see the note below).
  6. Click Sign Up.

Once your organization is provisioned, you see the Organization Created confirmation, you are signed in automatically, and you land on your new organization's Deployments page, ready to get started.

The person who creates the organization becomes its Owner, with full control over its members and settings.

info

The Organization Short Name becomes the identifier in your Console URL (for example /{short-name}/deployments). It must be unique, no longer than 32 characters, and contain no spaces. Choose it carefully. It is set when you create the organization.

Creating a Child Organization​

If your organization is set up as a Service Provider (MSP), you can create child organizations to manage your customers. Each child organization is a full organization in its own right, nested beneath yours.

To create a child organization:

  1. In the left navigation, open Service Provider, then select Child Organizations.
  2. Click Create Child Organization.
  3. In the modal, enter a Name and a Short Name for the new organization.
  4. Click Create.

The Service Provider section and the Create Child Organization button only appear for organizations that are permitted to create child organizations. If you do not see them, your organization is not set up as a service provider.

note

Child organizations are only available to Service Provider organizations. If your organization is not set up as a service provider, you will not see the Service Provider section.

Next Steps​

With your organization in place, here is where to go next: