mise-devcontainers

Ready-to-use Dev Containers built around mise, available for Alpine, Arch Linux, Debian, Fedora, and Ubuntu.

They follow the Dev Container specification and work with compatible editors, tools, or the Dev Container CLI.

Requirements

• Docker or a compatible container runtime
• a Dev Container-compatible tool
• an SSH agent exposed through SSH_AUTH_SOCK with at least one key loaded

Check the agent with:

ssh-add -L

The agent is forwarded for Git authentication and commit signing. Private keys never enter the container.

The included helper scripts additionally require the Dev Container CLI.

Templates

Templates are published as OCI artifacts and available through the Dev Container Templates collection:

• alpine
• archlinux
• debian
• fedora
• ubuntu

They can also be applied directly:

devcontainer templates apply \
  -t ghcr.io/mkvlrn/mise-devcontainers/archlinux \
  -w .

Replace archlinux with the desired distro.

Usage

Use the generated .devcontainer/ normally with any compatible Dev Container tool.

The templates also include helper scripts for standalone CLI usage. Make them executable once:

chmod +x .devcontainer/*.sh

# Create or start
.devcontainer/up.sh

# Recreate
.devcontainer/up.sh --recreate

# Open a shell
.devcontainer/shell.sh

# Stop
.devcontainer/down.sh

# Remove
.devcontainer/remove.sh

down.sh stops the container while keeping it available. remove.sh removes the container and temporary image.

Git

Git includes system-wide defaults and SSH commit signing through the forwarded agent.

Set your identity inside the container:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

If multiple keys are loaded in the agent, set user.signingKey to select one explicitly.

Included

All distros provide:

• mise
• Docker-in-Docker
• Fish
• Git with SSH signing
• SSH agent forwarding
• non-root dev user with sudo
• common CLI tools managed by mise
• projects mounted under /code/<project>

Project-specific runtimes remain with the project:

[tools]
node = "26"
pnpm = "11"

Distros

Distro	Base	Image
Alpine	3.24	ghcr.io/mkvlrn/mise-devcontainer-alpine
Arch Linux	Rolling	ghcr.io/mkvlrn/mise-devcontainer-archlinux
Debian	Trixie slim	ghcr.io/mkvlrn/mise-devcontainer-debian
Fedora	Rawhide	ghcr.io/mkvlrn/mise-devcontainer-fedora
Ubuntu	Current LTS	ghcr.io/mkvlrn/mise-devcontainer-ubuntu

Publishing

CI builds affected distros, tests their actual Dev Container templates against candidate images, then promotes the images and publishes the templates.