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.
Manage your organization settings
As an organization owner, you can manage the basic settings for your organization such as its name and URL.
Using the Console
Using the CLI
- Navigate to the organization you want to manage (or a project in it).
- Open the user menu (your name or profile picture).
- Click Settings.
- Click Edit to edit the label or click in the Organization URL field to edit the URL.
- Click Save.
To change the name (URL) and label of the acme organization, run:upsun organization:info --org acme label "Acme Corp" name acme-corp
To verify the changes, run:upsun organization:info --org acme-corp
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.
- Navigate to the organization you want to manage (or a project in it).
- Open the user menu (your name or profile picture).
- Click Billing.
Create a new organization
You can create new organizations with different payment methods and billing addresses
and organize your projects as you want.
Using the Console
Using the CLI
- Navigate to your existing organization or a project in it.
- Open the user menu (your name or profile picture).
- Click Create Organization.
- Enter the required information (label, organization URL, company name, country, security contact).
- Click Create organization.
To create an organization with the label Acme and the name (URL) acme, run:upsun organization:create --label "Acme" --name acme --country "United States"
To verify the changes, run:upsun organization:info --org acme
To monitor your spend, you can set billing alerts on your new organization.
Billing alerts are based on a current month estimate.
Once that estimate reaches a defined threshold, you receive an email notification.
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.
Using the Console
Using the CLI
- Navigate to your existing organization or a project in it.
- Open the user menu (your name or profile picture).
- Click Settings.
- Click Delete Organization.
- Confirm your decision by clicking Delete.
To delete the organization acme, run:upsun organization:delete --org acme
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.
- Make the new organization owner a project admin
for the project you want to transfer.
- To ask for the transfer, from your organization account open a support ticket.
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.
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. Then open a support ticket from the current organization to ask for the transfer.
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.
Fixed and Flex organizations
What is an Upsun Fixed organization?
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.New customers should use Upsun Flex.
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.
Fixed: Resources from the plan are applied to the production environment. For preview environments, the default small size is used for all containers.
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.
Flex: You can customize resources per container (per app or service) for all environments.
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 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 |
| 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/.
- 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?
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).
Yes.
- 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?
- You will see a list of all organizations.
- There is no field in the CLI that explicitly identifies Fixed vs Flex.
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.
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 sign-up for the 15-day trial for users creating Flex organizations.