README.md

HopplaOS

Quick Start

# Enable nix-command and flakes
mkdir -p ~/.config/nix
echo "experimental-features = nix-command flakes" >> ~/.config/nix/nix.conf
nix run "git+https://gitlab.vincentcui.de/vincent.cui/hopplaos -- -h

# if something went wrong and the repo has to be pulled with new changes
nix run --refresh "..." -- -h

When using the provided installer, the package is included:

install-system -h

Environment Setup

Enable devshell:

nix [--extra-experimental-features "nix-command flakes"] develop
# or
direnv allow # requires nix-direnv

Build and run test VM for nixosConfiguration

run-test-vm $CONFIGURATION_NAME

Troubleshooting

Test VM crashes after bootloader

Bug in qemu virtio-gpu-gl. Switch between virtio-vga and virtio-vga-gl to work around this issue (ctrl-alt-2, ctrl-alt-1).

Builds Upon

Flake Parts

• GitHub
• Docs

Tips & Tricks

Switch between dark and light theme

nix-specialisation-switch [dark,light]