Visnux Logo

visnux / wiki

Table of contents

1. Hey, what is this?

Welcome to Visnux! If you're here, you probably grabbed the ISO and want to get it running on your machine. This page walks through the steps I use to set it up. It shouldn't take long.

2. What the hell is a Visnux?

Visnux is an arch-based distro that is flexible, with a custom installer, and has cachyos kernel support and init freedom. Its logo is a tree (ask beamy not me lmao). But on a serious note, Visnux is still on its first release 4th version so it may come with bugs.

3. Flashing the USB

First things first, burn that ISO to a spare flash drive. Plug it in, find out what letter your drive is (like /dev/sdX—just be careful not to pick your main hard drive!), and run this in your terminal:

sudo dd if=visnux-1.0.0.iso of=/dev/sdX bs=4M status=progress oflag=sync

4. Setting up your partitions

Boot up from your USB. Depending on whether your PC is a bit older or newer, pick your setup below:

If you're on UEFI, make sure you booted into UEFI mode. Format your partitions and mount them up like this:

mkfs.fat -F32 /dev/efi_system_partition
mkfs.ext4 /dev/root_partition
mount /dev/root_partition /mnt
mkdir -p /mnt/boot
mount /dev/efi_system_partition /mnt/boot

Running legacy BIOS? Keep it simple with a standard MBR layout, format it to ext4, and mount it:

fdisk /dev/sdX
mkfs.ext4 /dev/sdX1
mount /dev/sdX1 /mnt

5. Install Visnux

With your drives partitioned and successfully mounted to /mnt, you are ready to bootstrap the base system files onto your disk. Ensure your internet connection is stable so the necessary packages can sync up properly before you begin the final steps.

5. Running the installer

Once everything is mounted and ready to roll, you don't have to mess with a bunch of manual scripts. Just type the magic word into your terminal:

You're almost done: Just run the built-in command and let it do its thing:

visnuxinstall

Reboot when it finishes, pull out the USB, and you should be good to go!

7. Credits

Big thanks to the team behind Visnux: