Minimal - check action

A Github Action that checks minimal configuration defined in your repo. Namely:

• Your minimal.toml file
• Package definitions
• Stack definitions

Features

• Runs on any Linux runner that supports unprivileged user namespaces.
• Supports both x86_64 and arm64 architectures.
• Selectable release channel
• Configurable to check all Minimal configuration, or specific packages/stacks

Usage

The following example steps check all minimal configuration defined in the repository, using a version of Minimal fetched from the unstable channel.

 - uses: actions/checkout@v7 # Checkout the repo to access its `minimal.toml`
 - name: Run check
   uses: gominimal/check@v1
   with:
     channel: unstable

Input parameters

• packages: An optional, comma-separated list of packages to check. If neither packages nor stacks are specified, then all packages are checked.
• stacks: An optional, comma-separated list of stacks to check. If neither packages nor stacks are specified, then all stacks are checked.
• channel: Release channel to fetch Minimal from; the channel is resolved to an exact version at run time. Defaults to stable.

Outputs

• version: Exact version string of Minimal which was used

Known-supported runners

We expect most distributions with modern (2024+) kernels to be able to run Minimal.

Github-hosted

• Ubuntu: ubuntu-slim, ubuntu-latest, ubuntu-26.04, ubuntu-24.04, ubuntu-26.04-arm, ubuntu-24.04-arm

Self-hosted

• Ubuntu: Version 24 or greater. Unprivileged user namespaces must be enabled.

  If unprivileged user namespaces are not enabled, the Github action will attempt to enable them using passwordless sudo. For runners which are not permitted to use sudo, you will need to set the appropriate sysctl yourself:

  sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0

• Debian: Bullseye (v11), Bookworm (v12), Trixie (v13) or greater.