repository·master·Indexed 42 days ago
https://github.com/void-linux/void-docsOfficial documentation for Void Linux, featuring the Void Linux Handbook for installing, configuring, and maintaining systems. Includes guides on Bluetooth setup, chroot environments using xvoidstrap and bubblewrap, virtualization with libvirt, and unprivileged LXC containers. Also contains the InfraDocs for managing project infrastructure.
Depending on your use case, other technologies may be more appropriate than manual chroots:
docker or podman and do not require manual creation of a chroot directory.Void Linux can run on low-powered hardware. Minimum recommended resources depend on the architecture and edition (glibc vs musl). Note that Xfce installation images require more resources than the base images.
Minimum Recommendations:
| Architecture | CPU | RAM | Storage |
|---|---|---|---|
| x86_64-glibc | x86_64 | 520MB | 700MB |
| x86_64-musl | x86_64 | 520MB | 600MB |
| i686-glibc | Pentium 4 (SSE2) | 520MB | 700MB |
Architecture Support:
x86_64, i686, aarch64, armv7l, and armv6l.glibc and musl are available on all architectures except i686 (which only supports glibc).i386, i486, or i586 architectures.Warning: If installing the musl edition, review the musl documentation first to understand software incompatibilities.
Each service managed by runit is defined by a service directory. At a minimum, a service directory must contain an executable named run which executes the process in the foreground.
Optional components include:
check: An executable run to verify if the service is available (exiting with 0 indicates success).finish: An executable run when the service is shut down or the process stops.conf: A configuration file containing environment variables to be sourced and referenced in the run script.log/: A directory containing a run process that acts as a logging facility, receiving the output of the main service's run process via a pipe.When a service runs for the first time, a supervise folder is automatically created in the directory.
When reading commands in the Void Linux documentation, use the following prefix symbols to identify the required user context:
$ : Run the command as a normal user.# : Run the command as root.Lines following these symbols that do not start with a prefix are typically the example output of the command.
elogind or seatd to manage sessions and seats.Void Linux supports several mutually exclusive methods for managing NVIDIA Optimus configurations:
| Method | Supported Drivers | Usage Pattern | Notes |
|---|---|---|---|
| PRIME Render Offload | nvidia, nvidia470 | prime-run <app> | Flexible; power saving depends on hardware (pre-Turing devices may not shut down completely). |
| RandR 1.4 Offloading | nvidia, nvidia470, nvidia390 | At X session start | Less flexible; allows complete shutdown of NVIDIA GPU to save power. |
| Bumblebee | nvidia, nvidia470, nvidia390 | optirun <app> | Unofficial; poor performance. |
| Nouveau PRIME | nouveau | DRI_PRIME=1 <app> | Uses open source driver; poor performance. |
Some PulseAudio applications require a D-BUS connection to function. Depending on the requirement, you may need to provide:
dbus-run-session).dbus service).Void Linux enables init_on_alloc by default for kernels 5.4 and greater. This provides security with minimal performance impact (<1%).
init_on_alloc: Enabled by default. Disable via kernel command line with init_on_alloc=0.init_on_free: Provides more security but has a higher performance cost (~5%). Enable manually via kernel command line with init_on_free=1.Legacy kernels (< 5.4): Use slub_debug=P page_poison=1 for similar hardening, though this has a higher performance impact.
Void Linux officially supports the musl libc implementation across all target platforms (except for i686, where binary packages are unavailable). For most compatible packages in the official repositories, musl-linked binaries are provided alongside their glibc counterparts.
Note the following repository availability for musl:
nonfree sub-repository, and debug sub-repository.multilib sub-repository for musl.