Platform.sh User Documentation

Organizations

Organizations allow you to manage your Platform.sh 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.

Manage your organization settings Anchor to this heading

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

  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.

To change the name (URL) and label of the acme organization, run:

platform organization:info --org acme label "Acme Corp" name acme-corp

To verify the changes, run:

platform organization:info --org acme-corp

Manage your organization billing Anchor to this heading

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.

  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.

Create a new organization Anchor to this heading

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

  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.

To create an organization with the label Acme and the name (URL) acme, run:

platform organization:create --label "Acme" --name acme --country "United States"

To verify the changes, run:

platform organization:info --org acme

Delete an existing organization Anchor to this heading

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.

  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.

To delete the organization acme, run:

platform organization:delete --org acme

Transfer project ownership Anchor to this heading

You can transfer your plan ownership to a different organization at anytime. You have to be an organization owner or have the manage plan permission.

  1. Make the new organization owner a project admin for the project you want to transfer.
  2. To ask for the transfer, from your organization account open a support ticket.

Once the transfer is completed, the new organization can administer all project settings and billing and receives future invoices. Ownership transfer automatically transfers subscription charges to the new organization.

Transfer organization ownership Anchor to this heading

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. Then open a support ticket from the current organization to ask for the transfer.

Fixed and Flex organizations Anchor to this heading

What is a Upsun Fixed organization? Anchor to this heading

Ideal for workloads that have consistent resource requirements with stable and predictable usage. Users can select a plan with predefined CPU and Memory resources. You can not adjust these resources, nor scale them automatically. To increase capacity, you’ll need to upgrade to a higher plan.

What is a Upsun Flex organization? Anchor to this heading

Ideal for workloads that evolve over time or have dynamic resource requirements. Flex will suit most use cases. Users will be able to allocate the exact CPU and Memory resources that your applications and services need. You can adjust these resources at any time, or configure them to adapt automatically. You are charged based on the resources you allocate.

What can you do? Anchor to this heading

When creating a new organization, users will be able to select the organization type from a drop-down option based on their preference. Once the organization is created, users can manage their organizations like they do today.

Feature differences Anchor to this heading

Developer experience Anchor to this heading

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 Anchor to this heading

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 Anchor to this heading

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

Support & SLAs Anchor to this heading

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 Anchor to this heading

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 & Compliance Anchor to this heading

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 Anchor to this heading

What happens to my URL? Anchor to this heading

  • 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? Anchor to this heading

  • 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? Anchor to this heading

  • Yes. You can navigate between organizations (Fixed or Flex) from a drop-down list.

How will Fixed vs Flex be identifiable in the console? Anchor to this heading

  • 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? Anchor to this heading

  • Correct.

Will I still use the same configuration files for Fixed projects? Anchor to this heading

  • 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? Anchor to this heading

Yes.

  • There will be a new way to create organizations (you can now choose Fixed or Flex).
  • Ability to navigate between organization types.
  • 15-day free trial for users creating Flex organizations.

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

  • 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? Anchor to this heading

Correct.

How can I anticipate my monthly invoice with usage-based pricing? Anchor to this heading

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? Anchor to this heading

Yes.

Can I use Blackfire for my Upsun applications? Anchor to this heading

Upsun includes Blackfire by default.

Will Upsun be delivered entirely on a “self service” model? Anchor to this heading

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

Can I try Upsun before buying? Anchor to this heading

Yes, you can sign-up for the 15-day trial.