Continuous integration

You can use Mise in continuous integration environments to provision the environment with the tools the project needs. We recommend that your project pins the tools to a specific version to ensure the environment is reproducible.

Any CI provider

Continuous integration pipelines allow running arbitrary commands. You can use this to install Mise and run mise install to install the tools:

script: |  curl https://mise.run | sh  mise install

To ensure you run the version of the tools installed by Mise, make sure you run them through the mise x command:

script: |  mise x -- npm test

Alternatively, you can add the shims directory to your PATH, if the CI provider allows it.

Bootstrapping

An alternative to calling curl https://mise.run | sh is to use mise generate bootstrap to generate a script that runs and install mise.

mise generate bootstrap -l -w

Add the .mise/ to your .gitignore and commit the generated ./bin/mise file. You can now use ./bin/mise to install and run mise directly in CI.

script: |  ./bin/mise install  ./bin/mise x -- npm test

GitHub Actions

If you use GitHub Actions, we provide a mise-action that wraps the installation of Mise and the tools. All you need to do is to add the action to your workflow:

name: test on:  pull_request:  branches:  - main  push:  branches:  - main jobs:  lint:  runs-on: ubuntu-latest  steps:  - uses: actions/checkout@v4  - uses: jdx/mise-action@v2  with:  version: 2024.12.14 # [default: latest] mise version to install  install: true # [default: true] run `mise install`  cache: true # [default: true] cache mise using GitHub's cache  experimental: true # [default: false] enable experimental features  # automatically write this mise.toml file  mise_toml: |  [tools]  shellcheck = "0.9.0"  # or, if you prefer .tool-versions:  tool_versions: |  shellcheck 0.9.0  - run: shellcheck scripts/*.sh

GitLab CI

You can use any docker image with mise installed to run your CI jobs. Here's an example using debian-slim as base image:

Example Dockerfile

FROM debian:12-slim  RUN apt-get update \  && apt-get -y --no-install-recommends install \  # install any tools you need  sudo curl git ca-certificates build-essential \  && rm -rf /var/lib/apt/lists/*  RUN curl https://mise.run | MISE_VERSION=v... MISE_INSTALL_PATH=/usr/local/bin/mise sh

When configuring your job, you can cache some of the Mise directories.

build-job:  stage: build  image: mise-debian-slim # Use the image you created  variables:  MISE_DATA_DIR: $CI_PROJECT_DIR/.mise/mise-data  cache:  - key:  prefix: mise-  files: ["mise.toml", "mise.lock"] # mise.lock is optional, only if using `lockfile = true`  paths:  - $MISE_DATA_DIR  script:  - mise install  - mise exec --command 'npm build'

Example with the bootstrap script

An alternative is to use mise generate bootstrap to easily bootstrap mise on GitLab CI.

mise generate bootstrap -l -w

You can now use a generic docker image such as this one to run and install mise in CI.

Example Dockerfile

FROM debian:12-slim  RUN apt-get update \  && apt-get -y --no-install-recommends install sudo curl git ca-certificates build-essential \  && rm -rf /var/lib/apt/lists/*

Here's an example of a .gitlab-ci.yml file:

.mise-cache: &mise-cache  key:  prefix: mise-  files: ["mise.toml", "./bin/mise"]  paths:  - .mise/installs  - .mise/mise-2025.1.3  build-job:  stage: build  image: my-debian-slim-image # Use the image you created  cache:  - <<: *mise-cache  policy: pull-push  script:  - ./bin/mise install  - ./bin/mise exec --command 'npm build'

Xcode Cloud

If you are using Xcode Cloud, you can use custom ci_post_clone.sh build script to install Mise. Here's an example:

#!/bin/sh curl https://mise.run | sh export PATH="$HOME/.local/bin:$PATH"  mise install # Installs the tools in mise.toml eval "$(mise activate bash --shims)" # Adds the activated tools to $PATH  swiftlint {args}