> ## Documentation Index
> Fetch the complete documentation index at: https://developer.upsun.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations

> See how to manage multiple Upsun projects at once through organizations.

Organizations allow you to manage your Upsun projects, users, and billing.
You can group multiple projects in one organization and manage them together.

To manage users within your organization, see how to [manage organization users](/docs/administration/users#manage-organization-users).

## Manage your organization settings

As an organization owner, you can manage the basic settings for your organization such as its name and URL.

<Tabs>
  <Tab title="Using the Console">
    1. Navigate to the organization you want to manage (or a project in it).
    2. Open the user menu (your name or profile picture).
    3. Click **Settings**.
    4. Click **Edit** to edit the label or click in the **Organization URL** field to edit the URL.
    5. Click **Save**.
  </Tab>

  <Tab title="Using the CLI">
    To change the name (URL) and label of the `acme` organization, run:

    ```bash theme={null}
    upsun organization:info --org acme label "Acme Corp" name acme-corp
    ```

    To verify the changes, run:

    ```bash theme={null}
    upsun organization:info --org acme-corp
    ```
  </Tab>
</Tabs>

## Manage your organization billing

As an organization owner or an organization user with the **Manage billing** permission,
you can access and download invoices and edit billing information such as the stored credit card and billing address.

<Tabs>
  <Tab title="Using the Console">
    1. Navigate to the organization you want to manage (or a project in it).
    2. Open the user menu (your name or profile picture).
    3. Click **Billing**.
  </Tab>
</Tabs>

## Create a new organization

You can create new organizations with different payment methods and billing addresses
and organize your projects as you want.

<Tabs>
  <Tab title="Using the Console">
    1. Navigate to your existing organization or a project in it.
    2. Open the user menu (your name or profile picture).
    3. Click **Create Organization**.
    4. Enter the required information (label, organization URL, company name, country, security contact).
    5. Click **Create organization**.
  </Tab>

  <Tab title="Using the CLI">
    To create an organization with the label `Acme` and the name (URL) `acme`, run:

    ```bash theme={null}
    upsun organization:create --label "Acme" --name acme --country "United States"
    ```

    To verify the changes, run:

    ```bash theme={null}
    upsun organization:info --org acme
    ```
  </Tab>
</Tabs>

<Note>
  To monitor your spend, you can [set billing alerts](/docs/administration/billing/monitor-billing#manage-billing-alerts) on your new organization.
  Billing alerts are based on a [current month estimate](/docs/administration/billing/monitor-billing#current-month-estimate).
  Once that estimate reaches a defined threshold, you receive an email notification.
</Note>

## Delete an existing organization

As an organization owner, you can delete your own organization.

Note that if your organization owns projects or owes remaining invoices, you can not delete it yourself.
To have it deleted, [contact support](/docs/core-concepts/get-support).

<Tabs>
  <Tab title="Using the Console">
    1. Navigate to your existing organization or a project in it.
    2. Open the user menu (your name or profile picture).
    3. Click **Settings**.
    4. Click **Delete Organization**.
    5. Confirm your decision by clicking **Delete**.
  </Tab>

  <Tab title="Using the CLI">
    To delete the organization `acme`, run:

    ```bash theme={null}
    upsun organization:delete --org acme
    ```
  </Tab>
</Tabs>

## Transfer project ownership

You can transfer your project ownership to a different organization at anytime.
To do this, you must be an organization owner or have the [manage billing permission](/docs/administration/users#organization-permissions).

1. Make the new organization owner a [project admin](/docs/administration/users)
   for the project you want to transfer.
2. To ask for the transfer, from your organization account open a [support ticket](/docs/core-concepts/get-support).

<Note>
  Once the project transfer is completed, the new organization can administer all project settings and billing and receives future invoices. Subscription charges are automatically transferred to the new organization.
</Note>

## Transfer organization ownership

To transfer an organization to a different owner, first make sure that user is part of the organization.
If they aren't yet, [add them](/docs/administration/users#add-a-user-to-an-organization). Then open a [support ticket](/docs/core-concepts/get-support) from the current organization to ask for the transfer.

<Note>
  Once the organization transfer is completed, the new organization owner can administer all organization and project settings, including billing. Note that transferring organization ownership does not automatically update the organization's payment method. The existing payment method remains on file until the new owner replaces it. The new owner should review and update the payment details at the time of transfer to avoid unintended charges to the previous payment method.
</Note>

## Fixed and Flex organizations

### What is an Upsun Fixed organization?

<Warning>
  Upsun Fixed is no longer available as a new offering and has been removed from the product catalog.

  Existing Upsun Fixed customers can continue to manage their organizations as before and can create new
  organizations by [contacting Support](https://fixed.docs.upsun.com/administration/organizations.html#create-a-fixed-organization).

  New customers should use [Upsun Flex](#what-is-an-upsun-flex-organization).
</Warning>

Upsun Fixed is designed for workloads with consistent, predictable resource requirements. With a Fixed organization, you select a plan with predefined CPU and memory resources. You cannot adjust these resources or scale them automatically. To increase capacity, you must upgrade to a higher plan.

<Info>
  **Fixed:** Resources from the plan are applied to the production environment. For preview environments, the default small size is used for all containers.
</Info>

### What is an Upsun Flex organization?

Upsun Flex is designed for workloads that evolve over time or have dynamic resource requirements, and suits most use cases.
With a Flex organization, you allocate the exact CPU and memory resources your applications and services need. You can adjust these resources at any time or configure automatic scaling. You are charged based on the resources you allocate.

By default, all new organizations are Flex organizations.

<Info>
  **Flex:** You can customize resources per container (per app or service) for **all** environments.
</Info>

### Feature differences

If you are an existing Upsun Fixed customer, you can use the information in this section to help you
decide whether to [convert](/tutorials/migration/from-fixed) your existing Upsun Fixed projects to Upsun Flex.

#### Developer experience

| **Feature**                                     | **Upsun Fixed**                              | **Upsun Flex**              |
| ----------------------------------------------- | -------------------------------------------- | --------------------------- |
| Manual backups                                  | Yes                                          | Yes                         |
| Health notifications                            | Yes                                          | Yes                         |
| Preview environments                            | Yes                                          | Yes                         |
| Free SSL certificates                           | Yes                                          | Yes                         |
| Source integrations (GitHub, GitLab, Bitbucket) | Yes                                          | Yes                         |
| Runtime operations                              | Yes                                          | Yes                         |
| Custom # of preview environments                | No (3 small included, purchase by bulk of 3) | Yes                         |
| Custom size of preview environments             | No                                           | Yes                         |
| Resource allocation                             | Project Level Plans                          | Container Level             |
| Custom build resources                          | No                                           | Yes                         |
| Autoscaling                                     | No                                           | Yes                         |
| Horizontal scaling of apps                      | No                                           | Yes                         |
| Guaranteed CPU                                  | No                                           | Yes                         |
| Dedicated architecture                          | Yes                                          | No                          |
| Custom domains on preview environments          | Enterprise and Elite only                    | Yes                         |
| Automated code updates                          | Enterprise and Elite only                    | Yes                         |
| Manual deployment                               | Enterprise and Elite only                    | Yes                         |
| Zero downtime deployment                        | Enterprise and Elite only                    | Yes                         |
| Custom backup retention policies                | Different packages                           | Unlimited (pay for storage) |
| Email SMTP server                               | Yes                                          | Yes                         |
| Email validation (DKIM)                         | Enterprise and Elite only                    | Yes                         |
| ElasticSearch (Premium containers)              | Enterprise and Elite only                    | No                          |
| MongoDB (Premium containers)                    | Enterprise and Elite only                    | No                          |

#### Observability tools

| **Feature**          | **Upsun Fixed**                                    | **Upsun Flex** |
| -------------------- | -------------------------------------------------- | -------------- |
| Logs forwarding      | Enterprise and Elite only                          | Yes            |
| Blackfire            | Enterprise and Elite only (or self-service add-on) | Yes            |
| HTTP Traffic         | Yes (but longer timeframe with Enterprise)         | Yes            |
| Continuous profiling | Enterprise and Elite only                          | Yes            |
| Resources            | Yes (but longer timeframe with Enterprise)         | Yes            |

#### User management

| **Feature**                | **Upsun Fixed**           | **Upsun Flex**   |
| -------------------------- | ------------------------- | ---------------- |
| Google SSO                 | Enterprise and Elite only | Yes, with add-on |
| OpenID Connect             | Elite only                | Yes, with add-on |
| Multifactor Authentication | Enterprise and Elite only | Yes, with add-on |
| Teams                      | Enterprise and Elite only | Yes, with add-on |

#### Support and SLAs

| **Feature** | **Upsun Fixed**                                | **Upsun Flex**   |
| ----------- | ---------------------------------------------- | ---------------- |
| Support SLA | Enterprise and Elite only                      | Yes, with add-on |
| Uptime SLA  | Enterprise and Elite only (Architecture based) | Yes, with add-on |
| CDN         | Enterprise and Elite only                      | Yes              |
| Fastly WAF  | Enterprise & Elite only as add-on              | Yes, with add-on |
| Upsun WAF   | Enterprise and Elite only                      | Yes              |

#### Billing

| **Feature**             | **Upsun Fixed**           | **Upsun Flex** |
| ----------------------- | ------------------------- | -------------- |
| Pay as you go (Monthly) | Yes                       | Yes            |
| Pay with credit card    | Yes                       | Yes            |
| Pay with SEPA           | Enterprise and Elite only | Yes            |
| Volume discounts        | No                        | Yes            |

#### Security and Compliance

| **Feature**                | **Upsun Fixed**                               | **Upsun Flex** |
| -------------------------- | --------------------------------------------- | -------------- |
| Privacy regulations        | Yes                                           | Yes            |
| SOC 2                      | Yes                                           | Yes            |
| PCI DSS Level 1-compatible | Yes                                           | Yes            |
| HIPAA                      | Enterprise and Elite only in specific regions | Coming soon    |

### Fixed and Flex FAQs

#### What happens to my URL?

* `https://auth.api.platform.sh/` will become `https://auth.upsun.com/`.

#### If I had a Fixed organization (previously Platform.sh), will I be redirected to my organizations?

* Yes. You will be automatically redirected to the new console and can log in using the same credentials.

#### Will I be able to switch if I have both Fixed and Flex organizations?

* Yes. If you already have both organization types, you can navigate between them from a drop-down list in the console.

#### How will Fixed vs Flex be identifiable in the console?

* Organizations will have tags next to their names in the console.
* Organizations will also be categorized by organization type in the console.

#### Will I be able to access Fixed projects via the Upsun CLI?

* Correct.

#### Will I still use the same configuration files for Fixed projects?

* Correct. The same configuration file structures remain (`.platform.app.yaml`, `.platform/services.yaml`, `.platform/routes.yaml`, etc).

#### Besides the name "Platform.sh" going away, will there be visual changes in the console?

Yes.

* Ability to navigate between organization types.
* <a class="link" href="https://auth.upsun.com/register/">**15-day free trial**</a> for users creating Flex organizations.

#### With a unified CLI, will there be a way to identify Fixed vs Flex in the project list?

* You will see a list of all organizations.
* There is no field in the CLI that explicitly identifies Fixed vs Flex.

#### Do Upsun projects run in the same regions as Platform.sh projects?

Correct.

#### How can I anticipate my monthly invoice with usage-based pricing?

Upsun gives a monthly price estimation for the current and next full month based on current usage pattern.

#### Can I use the same credentials / SSO / 2FA on Platform and Upsun?

Yes.

#### Can I use Blackfire for my Upsun applications?

Upsun includes Blackfire by default.

#### Will Upsun be delivered entirely on a “self service” model?

Yes. Additionally, Upsun offers discounts based on volume commitment that is contracted for 1+ Year.

#### Can I try Upsun before buying?

Yes, you can <a class="link" href="https://auth.upsun.com/register/">sign-up for the 15-day trial</a> for users creating Flex organizations.
