Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.


vpsAdminOS is a small OS serving as a hypervisor for unprivileged Linux system containers. It is based on not-os and NixOS. It is designed to run full distributions inside unprivileged containers which look and feel as much as a virtual machine as possible.

vpsAdminOS is developed and used in production by, a non-profit organization which provides virtual servers to its members. See vpsfree-cz-configuration for example cluster configuration.



Building OS

git clone
cd vpsadminos

vpsAdminOS is developed on top of the latest NixOS release, so make sure that the correct version of nixpkgs is in NIX_PATH, or set it as follows:

git clone --branch nixos-20.09
export NIX_PATH=`pwd`

vpsAdminOS can now be built and run:

# Build the OS

# Run under qemu
make qemu

QEMU runner creates two disk images - sda.img and sdb.img which are added as QEMU ATA drives and can be used to create a mirrored ZFS pool which persists across reboots.


# Login via ssh or use qemu terminal with autologin
ssh -p 2222 localhost

# Configure osctld:
osctl pool install tank

# Create a container:
osctl ct new --distribution alpine myct01

# Configure container networking:
# Bridged veth
osctl ct netif new bridge --link lxcbr0 myct01 eth0

# Routed veth
osctl ct netif new routed myct01 eth1
osctl ct netif ip add myct01 eth1

# Start the container:
osctl ct start myct01

# Work with containers:
osctl ct ls
osctl ct attach myct01
osctl ct console myct01
osctl ct exec myct01 ip addr

# More information:
man osctl


Converting OpenVZ Legacy containers into vpsAdminOS

vpsAdminOS Converter can be used to convert OpenVZ Legacy containers containers into vpsAdminOS. See the documentation.

Nested containers

vpsAdminOS supports nested containers, e.g. LXC/LXD or Docker.

Nesting LXC/LXD containers can be enabled per container using:

osctl ct set nesting <id>

Docker works out-of-the-box with several known issues.

Building specific targets

nix-build -A -o tftpdir
nix-build -A



Hypervisor for Linux system containers based on NixOS, ZFS and LXC



No releases published


No packages published
You can’t perform that action at this time.