Skip to main content

Setting the stack for your builds

The build stack indicates the virtual machine version that we will use to run your build. You can set the stack for all your builds, or you can set Workflow-specific stacks.

Changing machine types using the API

You can also change build machine types for all apps owned by a single user or Workspace using the API: Changing machine types in all apps at the same time.

Setting the stack in the Workflow EditorClick to copy link​

The simplest way to configure the build stack is in the Workflow Editor. You can set both the default stack and Workflow-specific stacks.

Setting the default stackClick to copy link​

The default stack of your app is the stack that is used if you haven't set a specific stack for a Workflow.

Project type

Note that if you change the project type on the app's Settings tab to a type that isn't compatible with your selected default stack, we'll automatically change the stack to a compatible one.

  1. Log in to Bitrise and select Bitrise CI on the left, then select your project.

  2. Click the Workflows button on the main page.

    workflows-button.png

  3. On the left, select Stacks & Machines.

  4. In the Default Stack section, open the dropdown menu and select the stack you need.

  5. Click Save changes in the top right corner.

Setting a Workflow-specific stackClick to copy link​

When you set a stack for a Workflow, that Workflow will always run on that stack, regardless of the default stack.

  1. Log in to Bitrise and select Bitrise CI on the left, then select your project.

  2. Click the Workflows button on the main page.

    workflows-button.png

  3. On the left, select Stacks & Machines.

  4. Scroll down to find the Workflow you need.

  5. Select a stack.

  6. Click Save changes in the top right corner.

Setting the machine type in the Workflow EditorClick to copy link​

You can define the machine type you want to use for your build in the Workflow Editor. The available machine types depend on the type of stack you use: Build machine types.

To set the machine type:

  1. Log in to Bitrise and select Bitrise CI on the left, then select your project.

  2. Click the Workflows button on the main page.

    workflows-button.png

  3. On the left, select Stacks & Machines.

  4. In the Default Stack section, find the Machine type for the default stack section and choose a machine type.

    machine-type-selector.png

  5. Optionally, choose a Workflow-specific machine type for any Workflow that has a Workflow-specific stack set.

Setting the stack in the Configuration YAMLClick to copy link​

You can set both the default stack and Workflow-specific tasks in your project's Configuration YAML. Use the meta field with the appropriate stack ID:

meta:      
  bitrise.io:       
    stack: <stack-id>

This is particularly useful if you keep your bitrise.yml file stored in your app's repository.

Stack IDs

You can find the stack IDs on the top of each stack report: Bitrise stack reports. Alternatively, you can set a stack in the Workflow Editor and then check out the ID on the bitrise.yml tab, by finding the meta field.

The stack reports also show every pre-installed tool that is available on the stack.

Setting the default stack in the Configuration YAMLClick to copy link​

The default stack of your app is the stack that is used if you haven't set a specific stack for a Workflow.

  1. Open your project's Configuration YAML.

  2. Add a meta entry outside the workflows property or at the end of your Configuration YAML:

    meta:      
      bitrise.io:       
        stack:

    Make sure you use double indentation.

  3. Add the stack ID.

    You can find the stack IDs on the stack reports page: the filenames without the .log extension are the stack IDs.

    meta:      
      bitrise.io:       
        stack: <stack-id>

Setting Workflow-specific stacks in the Configuration YAMLClick to copy link​

When you set a stack for a Workflow, that Workflow will always run on that stack, regardless of the default stack.

  1. Open your project's Configuration YAML.

  2. Find the workflows property and find the name of the Workflow you need within.

  3. Add a meta entry under the Workflow itself:

    workflows:
      deploy:  
        meta:      
          bitrise.io:       
            stack:

  4. Add the stack ID.

    You can find the stack IDs on the top of each stack report page.

    workflows:
      deploy:  
        meta:      
          bitrise.io:       
            stack: <stack-id>

Setting the machine type in the Configuration YAMLClick to copy link​

You can also define the machine type you want to use for your build in your project's Configuration YAML. Machine type refers to the hardware resources used in your build; for example, an Elite machine has more CPU cores and available RAM than a Standard machine.

To set the machine type in Configuration YAML file, you need to use the machine_type_id attribute in a meta entry:

Available machine IDs

You can find the available machine type IDs here: Build machine types.

  1. Open your project's Configuration YAML file.

  2. Find the workflows property and find the name of the Workflow you need within.

  3. Add a meta entry:

    # setting an 8-core Gen2 machine for an Xcode stack as the default machine type of the app:
    meta:
      bitrise.io:
        machine_type_id: g2.8core
    # setting a 12-core Gen2 machine as a Workflow-specific machine type
    workflows:
      deploy:  
        meta:      
          bitrise.io:       
            machine_type_id: <machine-id>

Build machine typesClick to copy link​

Bitrise offers multiple build machines with different specifications You can choose between them based on your needs.

You can track how much time you spent building your apps on each machine type with Insights: Bitrise CI metrics.

Machine availability by subscription plan

Not all machines are available on all subscription plans. Visit the pricing page to find out which machines are available on your plan!

Machine types are divided into resource classes. The same resource class offers multiple machine types with broadly similar performances. Bitrise automatically assigns machine types from a resource class, which means that on the same day, your builds might run on different machine types.

Operating systemResource classHardware typesSpecsMachine type ID for YAML configuration
macOS
Medium- M2 Pro Medium - M4 Medium- 4 CPU @3.49GHz and 6 GB RAM - 5 CPU @4.4 GHz and 6 GB RAMg2.mac.medium
Large- M2 Pro Large - M4 Large- 6 CPU @3.49GHz and 14 GB RAM - 5 CPU @4.4 GHz and 14 GB RAMg2.mac.large
X Large- M2 Pro X Large - M4 X Large- 12 CPU @3.49GHz and 28 GB RAM - 10 CPU @4.4 GHz and 28 GB RAMg2.mac.x-large
4LargeM4 Pro Large7 CPU @4.52GHz and 27 GB RAMg2.mac.4large
4X LargeM4 Pro X Large14 CPU @4.52GHz and 54 GB RAMg2.mac.4x-large
LinuxMedium4 vCPU @ 3.1 GHz4 vCPU @3.1 GHz and 16 GB RAMstandard
Large8 vCPU @ 3.1 GHz8 vCPU @3.1 GHz and 32 GB RAMelite
X Large16 vCPU @ 3.1 GHz16 vCPU @3.1 GHz and 64 GB RAMelite-xl
MAMD EPYC Zen 4 and Zen 54 vCPU @3.7 GHz and 16 GB RAMg2.linux.medium
2MAMD EPYC Zen 4 and Zen 56 vCPU @3.7 GHz and 24 GB RAMg2.linux.2medium
LAMD EPYC Zen 4 and Zen 58 vCPU @3.7 GHz and 32 GB RAMg2.linux.large
4LAMD EPYC Zen 4 and Zen 514 vCPU @3.7 GHz and 56 GB RAMg2.linux.4large
XLAMD EPYC Zen 4 and Zen 516 vCPU @3.7 GHz and 64 GB RAMg2.linux.x-large
3XLAMD EPYC Zen 4 and Zen 524 vCPU @3.7 GHz and 96 GB RAMg2.linux.3x-large
5XLAMD EPYC Zen 4 and Zen 532 vCPU @3.7 GHz and 128 GB RAMg2.linux.5x-large
7XLAMD EPYC Zen 4 and Zen 548 vCPU @3.7 GHz and 192 GB RAMg2.linux.7x-large