Skip to content

Install microCI

microCI is designed to stay lightweight: one YAML pipeline, one generated Bash script, and a small set of runtime requirements.

Requirements

microCI relies on a small set of standard tools:

  • bash โ€” runs the generated pipeline script
  • docker โ€” provides isolated execution environments for steps
  • jq โ€” handles JSON data when pipelines need to inspect or transform structured output
  • yq โ€” handles YAML data when pipelines need to read or update configuration files

These tools are necessary because microCI generates Bash and expects a minimal runtime layer to execute portable steps consistently across machines.

At runtime, the simplicity stays the same: microCI | bash.

To run only specific steps, use -O/--only for a single named step or -N/--number with one or more comma-separated step numbers, such as microCI --number 2,3,5.

Install

![Install](images/microci-install.svg)
curl -fsSL https://microci.dev/install.sh | bash

Update

Keep the same workflow and refresh the binary:

![Update](images/microci-update.svg)
microCI --update | bash

To track development builds instead:

microCI --update-dev | bash

Remove

Remove microCI from your system:

![Uninstall](images/microci-uninstall.svg)
microCI --uninstall | bash