NanumOS

Install

There are four ways to use NanumOS. Install it like an app on the computer you use now (Mac, Windows, Linux), boot a laptop from a USB stick, run it as a VM on a server or VPS, or try it in a browser. This page gives the real steps for each and the limits that apply today.

Choose a way

You want toWayStatus
Use it in a window on the computer you haveThe Mac, Windows and Linux installersChecked on Mac and Linux. Windows not yet started on a real PC
Try it on a laptopBoot from a USB stick (UEFI)Checked on one model only (one Intel laptop)
Keep it on the laptop's internal diskInstall as one file inside the diskChecked on the same model only
Use it on a MacNanumOS.app (Apple silicon)What works and what does not is listed below
Run it on a server or VPSA VM with zeusos-vmStarts only from signed releases
Look around without installingThe browser demoYou need an invite link

Install it like an app on the computer you have

NanumOS is a whole computer that runs inside one window on your computer. Like a picture-in-picture TV, NanumOS in the window cannot see or change your computer's files. You never type a command.

ComputerDownloadInstall
Windows 10 or 11 (64-bit)ZeusOs-Setup-version.exeDouble-click it, press OK
Linux (64-bit Intel or AMD)zeusos-version-linux-x86_64.tar.gzUnpack it and run sh install.sh in that folder

Your files

Your NanumOS files are in one place only. They save by themselves about two seconds after a change.

ComputerPlace
Windows%LOCALAPPDATA%\NanumOS

Updates

Remove

"Keep my files" brings them back when you install again. "Delete everything" cannot be undone.

A laptop from a USB stick

What you need

Make the stick

  1. Open the USB writer tool that comes with the release.
  2. Name the stick yourself. The tool never picks a stick for you.
  3. Give it the stick's exact size in bytes, the image's SHA-256 and the erase-confirm word. If any one of them does not match, nothing is written.
  4. After writing, the tool reads the stick back and checks that it matches the image.
  5. To keep your files after power-off, also give a storage area size when you write (64 MiB or more). Without a storage area, files live in memory only and are gone when you turn it off.

If a storage area of the same size is already on the stick, writing a new version keeps it. Use the wipe option only when you want it emptied.

Boot it

  1. In the laptop's firmware setup, turn Secure Boot off. The NanumOS boot file is not signed, so Secure Boot blocks it.
  2. Insert the stick, power on, and pick the USB entry in the firmware boot menu. The key that opens the menu depends on the maker.
  3. When the boot lines finish and Welcome to NanumOS and a prompt appear, it is running. Type gui to open the desktop. See First boot.

While you run from the stick, the laptop's internal disk is not touched.

Install to the internal disk as one file

No repartitioning. The installer makes one file, /zeusos/disk.img, inside the ext4 partition of a Linux such as Ubuntu, and adds one UEFI boot entry. Linux stays the first boot entry. This way works only on an NVMe disk that already has Linux on it.

  1. On the Linux side, put the install script zeusos-install-file.sh and the boot file in one folder.
  2. Run the dry run first. It writes nothing and only shows the plan.
   sudo ./zeusos-install-file.sh plan --size 64G --loader BOOTX64.EFI
  1. If the plan has even one REFUSED: line, stop. If it has none, run the same line with plan replaced by install --apply. Writing takes one to two minutes.
  2. Run sudo ./zeusos-install-file.sh status and check that it ends with status: PASS.
  3. The boot entry is not put first in the boot order. Normally Linux starts. To start NanumOS, pick the NanumOS entry in the firmware boot menu, or boot it once only (the next boot is the original OS). At first NanumOS only reads the disk. Writing is opened only after the read-only check passes.
  4. To remove it, run uninstall (a dry run) and then uninstall --apply.

The script refuses in these cases: free space is less than the file size plus 50 GiB, the file system is not ext4, the disk is not NVMe, the boot partition is not on the same disk, or a NanumOS file or entry already exists. When it refuses, it writes nothing.

What stays untouched

Limits

A Mac: NanumOS.app

On an Apple silicon Mac, NanumOS runs in a window. It uses the Mac's own virtualization, so QEMU is not needed. The window opens straight into the desktop.

How to use it

  1. Double-click NanumOS.app. Full screen is Control-Command-F.
  2. The mouse is not captured inside the window. It acts like a USB tablet and moves in and out freely.
  3. Closing the window is the same as forcing the power off. Check inside NanumOS that your work is saved first. Files save by themselves about two seconds after a change.
  4. To quit the app, hold the command key and press Q.
  5. On a Mac keyboard, Alt is the option key.
  6. Text you copy on the Mac pastes in NanumOS, and the other way round.

Your files are saved automatically in Application Support/NanumOS/home.raw in your user Library. serial.log in the same folder is the start-up record.

Limits

A server or VPS as a VM

You can run several headless NanumOS VMs. Each VM has its own work disk that persists, and you reach it from outside with ssh. The tool is zeusos-vm.

zeusos-vm

You need QEMU, Python 3 and the cryptography package for checking signatures. On Linux it runs with KVM when /dev/kvm works. Otherwise it runs the slow way, which is slow on a VPS that blocks virtualization.

CommandWhat it does
zeusos-vm fetch VERSIONDownloads a release, checks signature and hash, and stores it. The download address is set by the environment variable ZEUSVM_RELEASE_URL
zeusos-vm import DIRChecks a release folder you already have and stores it
zeusos-vm imagesShows the stored releases and the default one
zeusos-vm start NAMEStarts a VM. A new VM revives a frozen template, so it starts fast
zeusos-vm listShows VM names, state, version and the access port
zeusos-vm exec NAME COMMAND...Runs one command
zeusos-vm ssh NAMEOpens an interactive shell
zeusos-vm stop NAMESaves and stops. The next start is fast
zeusos-vm upgrade NAME --version VERSIONTakes a snapshot of the work disk, then restarts on the new version
zeusos-vm journal NAMEShows the record of what the VM did. The VM cannot write this record
zeusos-vm rm NAMEStops it and deletes the work disk, record and snapshots

Other UEFI VMs

You can also use the same image as the disk of a UEFI VM (QEMU with OVMF, for example). You see the screen over VNC and type through the VM console. It starts at the console like a laptop, so type gui.

Try it in a browser

With an invite link you can open NanumOS in a browser without installing it. One button starts a VM just for you, and the desktop appears a few seconds later.

Limits

Not yet

NanumOS 0.1.8349 · 2026-11-16