https://wiki.alpinelinux.org/w/api.php?action=feedcontributions&feedformat=atom&user=DonnoAlpine Linux - User contributions [en]2026-05-09T23:41:15ZUser contributionsMediaWiki 1.40.0https://wiki.alpinelinux.org/w/index.php?title=Runc&diff=30350Runc2025-07-05T12:37:27Z<p>Donno: Provide additional explanation and information</p>
<hr />
<div>{{DISPLAYTITLE:runc}}[https://github.com/opencontainers/runc runc] is a CLI tool for spawning and running containers on Linux according to the OCI specification, implemented in Go. This page provides instructions to setup containers using runc.<br />
<br />
The tool is meant as a low-level tool and is intended to deal with the plumbing of container. The expectaiton is is it is used by higher level container software (such as [[Docker]] and [[Podman]]) to provide an interface better suited at common tasks. However, it can be useful for learning how things work, small tests or building your own tooling.<br />
<br />
== Prerequisites ==<br />
<br />
* Enable [[OpenRC#cgroups|cgroups]]<br />
<br />
== Set up a minimal container ==<br />
<br />
Here are the steps to create a minimal container using runc and Alpine Linux.<br />
This creates an OCI bundle <br />
<br />
{{Cmd|# apk add runc}}<br />
{{Cmd|# mkdir /opt/busybox-container}}<br />
{{Cmd|# apk --arch x86_64 -X <nowiki>https://dl-cdn.alpinelinux.org/alpine/edge/main/</nowiki> --root /opt/busybox-container/rootfs --initdb --no-cache --allow-untrusted add busybox}}<br />
{{Cmd|# cd /opt/busybox-container && runc spec}}<br />
{{Cmd|# runc run busybox-1}}<br />
<br />
== About ==<br />
The creation of the root filesystem and the generation of the spec file is creating what is known as an OCI bundle. By using the Alpine Package Keeper (APK), we can create a bundle from pre-built software available for Alpine.<br />
<br />
The {{Cmd|runc spec}} command generates a config.json file which follows the [https://github.com/opencontainers/runtime-spec/blob/main/spec.md OCI Runtime Specification]. This configuration file can be modified to set-up mounts within the container amongst other settings.<br />
<br />
== Alternatives ==<br />
An alternative to [https://github.com/containers/crun runc] is crun which is a fast and lightweight fully featured OCI runtime and C library for running containers.<br />
The commands in the example above can be switched to use crun instead and it can be installed with {{Cmd|# apk add crun}}<br />
<br />
== See also ==<br />
<br />
* [https://github.com/opencontainers/runc/tree/main?tab=readme-ov-file#using-runc Official User Guide]<br />
<br />
[[Category:Virtualization]]</div>Donnohttps://wiki.alpinelinux.org/w/index.php?title=Runc&diff=30343Runc2025-07-05T07:27:50Z<p>Donno: Mention that this works with crun too.</p>
<hr />
<div>{{DISPLAYTITLE:runc}}[https://github.com/opencontainers/runc runc] is a CLI tool for spawning and running containers on Linux according to the OCI specification, implemented in Go.. This page provides instructions to setup containers using runc.<br />
<br />
== Prerequisites ==<br />
<br />
* Enable [[OpenRC#cgroups|cgroups]]<br />
<br />
== Set up a minimal container ==<br />
<br />
Here are the steps to create a minimal container using runc and Alpine Linux.<br />
This creates an OCI bundle <br />
<br />
{{Cmd|# apk add runc}}<br />
{{Cmd|# mkdir /opt/busybox-container}}<br />
{{Cmd|# apk --arch x86_64 -X <nowiki>https://dl-cdn.alpinelinux.org/alpine/edge/main/</nowiki> --root /opt/busybox-container/rootfs --initdb --no-cache --allow-untrusted add busybox}}<br />
{{Cmd|# cd /opt/busybox-container && runc spec}}<br />
{{Cmd|# runc run busybox-1}}<br />
<br />
<br />
== Alternatives ==<br />
An alternative to [https://github.com/containers/crun runc] is crun which is a fast and lightweight fully featured OCI runtime and C library for running containers.<br />
The commands in the example above can be switched to use crun instead and it can be installed with {{Cmd|# apk add crun}}.<br />
<br />
== See also ==<br />
<br />
* [https://github.com/opencontainers/runc/tree/main?tab=readme-ov-file#using-runc Official User Guide]<br />
<br />
[[Category:Virtualization]]</div>Donno