Onix Micro VM

Small VM containing a collection of cybersecurity tools.

The VM disk image will take 7M on disk (on the first boot), because the actual binnaries are never copied to it, they are only stored on the host (in /nix/store/) and a share is mounted on the VM.

Usage

Requirements

The only requirement to start the Onix micro VM is Nix.

Run

nix --extra-experimental-features "nix-command flakes" run github:onix-sec/onix-vm

Or if you want to change the configuration clone the repo:

git clone https://github.com/onix-sec/onix-vm.git
cd onix-vm

You can edit modules/packages.nix to choose the tools you need.

Build the Nix packages:

nix --extra-experimental-features "nix-command flakes" run

The first launch will be significantly slower than following ones, because Nix needs to download or compile packages.

Note

To stop the VM run poweroff in it.

Note

The VM disk will be created in onix.qcow2.

VM defaults can be configured in modules/vm.nix and are:

• 2 vCPU
• 4Gb of RAM

SSH

SSH is enabled by default, you can add your key in modules/system.nix in openssh.authorizedKeys.keys:

ssh -p 2222 user@localhost

TODO

• Add CLI to configure VM with flags
• Add CLI to extend the Nix configuration

License

Onix Micro VM is licensed under MIT.