Resource configuration

When you first deploy your project or add a new app or service to it, Upsun allocates default resources to each of your containers. If you don’t want to use those default resources, define a different resource initialization strategy.

After the initial deployment, or if you opt for the Manual resource initialization strategy, you can adjust container resources manually. To do, follow the instructions on this page.

Upsun allows you to configure resources (CPU, RAM, and disk) per environment for each of your apps and services. You can also add instances for each of your apps depending on your needs.

For example, you can scale vertically and allocate more resources to your production and staging environments than to your development environments. This flexibility allows you to optimize performance and costs.

You can even scale horizontally if your apps are struggling with high load, or if you’re expecting a traffic spike, by adding more instances for your apps and workers.

For information on costs related to resource usage, see the Upsun pricing page.

Note that you can monitor these costs in the Console.

Vertical scaling

To define how much CPU, RAM, and disk storage you want to allocate to each individual container, follow these steps:

Horizontal scaling

For apps and workers, you can also define how many instances you want to deploy. To do so, follow these steps:

Advanced: Container profiles

By default, Upsun allocates a container profile to each app and service depending on the range of resources it’s expected to need.

Each container profile gives you access to a specific list of CPU and RAM combinations. Using the Upsun CLI or Console, you can then pick a CPU and RAM combination for each of your apps and services.

There are four container profiles available: HIGH_CPU, BALANCED, HIGH_MEMORY, and HIGHER_MEMORY. The following table displays the different CPU and RAM combinations each container profile provides:

You can check which container profile is set for an app or service in your project from the Console. To do so, navigate to your environment and select the app or service in the tree on the left-hand side:

For information on resource-related costs, see the Upsun pricing page.

Default container profiles

The following table shows the default container profiles Upsun applies when first deploying your project.

Adjust a container profile

In most cases, it’s best not to adjust container profiles. As a best practice, Upsun recommends adjusting the profile of a container only if the CPU/RAM ratio doesn’t match how the container scales, taking into account both production and preview (staging and development) environments.

To adjust a container profile, amend the value of the container_profile key in your configuration:

applications:
    APP_NAME:
        container_profile: HIGH_MEMORY

services:
    SERVICE_NAME:
        type: SERVICE_TYPE:VERSION
        container_profile: HIGHER_MEMORY