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 to | Way | Status |
|---|---|---|
| Use it in a window on the computer you have | The Mac, Windows and Linux installers | Checked on Mac and Linux. Windows not yet started on a real PC |
| Try it on a laptop | Boot from a USB stick (UEFI) | Checked on one model only (one Intel laptop) |
| Keep it on the laptop's internal disk | Install as one file inside the disk | Checked on the same model only |
| Use it on a Mac | NanumOS.app (Apple silicon) | What works and what does not is listed below |
| Run it on a server or VPS | A VM with zeusos-vm | Starts only from signed releases |
| Look around without installing | The browser demo | You 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.
| Computer | Download | Install |
|---|---|---|
| Windows 10 or 11 (64-bit) | ZeusOs-Setup-version.exe | Double-click it, press OK |
| Linux (64-bit Intel or AMD) | zeusos-version-linux-x86_64.tar.gz | Unpack it and run sh install.sh in that folder |
- The first start explains in plain words what it is, where your files are, and how updates and removing work.
- Windows and Linux need QEMU, a free program that runs virtual computers, installed separately. If it is missing, NanumOS tells you where to get it. On Linux:
sudo apt install qemu-system-x86 ovmf(Ubuntu, Debian). On Windows, turning on "Windows Hypervisor Platform" makes it fast. - Intel Macs are not supported. The app says so when you open it.
Your files
Your NanumOS files are in one place only. They save by themselves about two seconds after a change.
| Computer | Place |
|---|---|
| Windows | %LOCALAPPDATA%\NanumOS |
Updates
- New versions download by themselves once a day and are used the next time you start NanumOS. Only correctly signed versions are taken.
- The system is kept twice. If a new version fails to reach the desktop two starts in a row, NanumOS goes back to the one you had.
- Your files stay as they are when the version changes, also when you download a new installer and open it.
Remove
- Mac: menu NanumOS › Uninstall NanumOS
- Windows: Settings › Apps › Installed apps › NanumOS › Uninstall
- Linux:
zeusos uninstall
"Keep my files" brings them back when you install again. "Delete everything" cannot be undone.
A laptop from a USB stick
What you need
- An x86-64 PC that boots with UEFI and has UEFI graphics (GOP).
- A USB stick of 64 MiB or more. Anything on it becomes unreadable.
- The official image file and its SHA-256 value. You get the image from a release. Check the SHA-256 of the file you downloaded.
Make the stick
- Open the USB writer tool that comes with the release.
- Name the stick yourself. The tool never picks a stick for you.
- 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.
- After writing, the tool reads the stick back and checks that it matches the image.
- 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
- In the laptop's firmware setup, turn Secure Boot off. The NanumOS boot file is not signed, so Secure Boot blocks it.
- 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.
- When the boot lines finish and
Welcome to NanumOSand a prompt appear, it is running. Typeguito 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.
- On the Linux side, put the install script
zeusos-install-file.shand the boot file in one folder. - Run the dry run first. It writes nothing and only shows the plan.
sudo ./zeusos-install-file.sh plan --size 64G --loader BOOTX64.EFI
- If the plan has even one
REFUSED:line, stop. If it has none, run the same line withplanreplaced byinstall --apply. Writing takes one to two minutes. - Run
sudo ./zeusos-install-file.sh statusand check that it ends withstatus: PASS. - The boot entry is not put first in the boot order. Normally Linux starts. To start NanumOS, pick the
NanumOSentry 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. - To remove it, run
uninstall(a dry run) and thenuninstall --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
- The partition table is not changed. Nothing is formatted.
- The boot order is not changed. Only an entry is added, and the installer checks the order is the same before and after.
- Firmware keys and Secure Boot settings are not changed.
- NanumOS can write only inside fixed areas of its own file. Every write that would leave those areas is refused.
- If NanumOS hangs, power-cycle the laptop. The normal boot is the original OS.
Limits
- The one model checked is an Intel laptop. Other models may or may not boot.
- Only the Intel AX201 Wi-Fi chip works. With other chips, use a USB network adapter or phone tethering.
- The boot file is unsigned, so it will not boot with Secure Boot on.
- There is no internal-disk encryption yet. The administrator of the Linux can read that file.
- The installer refuses if the file ends up in more than 256 pieces.
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
- Double-click NanumOS.app. Full screen is Control-Command-F.
- The mouse is not captured inside the window. It acts like a USB tablet and moves in and out freely.
- 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.
- To quit the app, hold the command key and press Q.
- On a Mac keyboard, Alt is the option key.
- 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
- If you resize the window, the picture only grows. It does not shrink or re-fit.
- The sound device exists, but playback has not been confirmed.
- The Chromium app (the Linux VM browser) does not work in this window yet.
- Sideways trackpad swipes arrive, but only Weather, Calendar and Photos use them.
- Booting the Mac itself into NanumOS is at the design stage. It was checked inside QEMU, not yet on a real Mac.
- The installer has no Apple developer signature yet. On another Mac, open it the first time with right-click › Open.
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.
| Command | What it does |
|---|---|
zeusos-vm fetch VERSION | Downloads a release, checks signature and hash, and stores it. The download address is set by the environment variable ZEUSVM_RELEASE_URL |
zeusos-vm import DIR | Checks a release folder you already have and stores it |
zeusos-vm images | Shows the stored releases and the default one |
zeusos-vm start NAME | Starts a VM. A new VM revives a frozen template, so it starts fast |
zeusos-vm list | Shows VM names, state, version and the access port |
zeusos-vm exec NAME COMMAND... | Runs one command |
zeusos-vm ssh NAME | Opens an interactive shell |
zeusos-vm stop NAME | Saves and stops. The next start is fast |
zeusos-vm upgrade NAME --version VERSION | Takes a snapshot of the work disk, then restarts on the new version |
zeusos-vm journal NAME | Shows the record of what the VM did. The VM cannot write this record |
zeusos-vm rm NAME | Stops it and deletes the work disk, record and snapshots |
- A release starts only when its signature (ed25519) and SHA-256 are right. A changed image is refused even by one bit. The public keys you trust go in
release.pub. - The network is the user-mode network QEMU provides.
- To attach a host folder, name exactly one with
--share. Your home folder,/and any folder above them are refused. A non-empty folder that is not a git repository is refused. The folder is read-write, and a warning prints at every start. A VM with a shared folder cannot resume fast, so it starts slower. - A VM always starts on the version it was made with. Only
upgradechanges it.
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.
- A session is 15 minutes. When it ends, everything is deleted. No files are kept.
- Hangul uses NanumOS's own input method. Leave the browser's or computer's input method on English and switch Korean/English with
Shift+Space. - A phone gets the phone-shaped screen. For Hangul, press the
가Abutton on the page to open a text field. See Phone version.
Limits
- It is too early to give it real services. For now these are test and work VMs.
- Each person gets an invite link of their own.
Not yet
- There is no public place yet where anyone can download the official image and installers. Get them and their SHA-256 from the person who gave you NanumOS.
- The Windows installer has not been started on a real Windows PC yet.
- The laptop install was checked on one model only.
- There is no way to install NanumOS on a phone itself. On a phone, open the Phone version in a browser.
- The laptop and internal-disk installs have no install wizard. They are done with commands.
NanumOS 0.1.8349 · 2026-11-16