NanumOS

Inside the OS

What NanumOS does under the screen. The kernel and booting, storage and restore points, app isolation, networking, devices, Korean input, the vault and virtual machines, each described by what it does and how it works.

This page explains the work NanumOS does behind the screen. Each item says what it does and how it works first; numbers and file names are in the folded "Technical details". Status badges are set automatically from the repository data. The server side is on Using it as a server.

Kernel and booting

Our own kernel

Status: Ready

What it does — The core program that wakes first when the computer starts and organises memory, the order programs run in, files and the network. NanumOS wrote this core from scratch, and the same source runs on ordinary PC chips (x86) and on the ARM chips used in Macs and phones (arm64).

How it works — Think of the pillars and plumbing of a building. Apps never touch the machine directly; they ask the kernel, which decides order and place.

Technical details
  • Written in C. x86_64 and arm64 share one source tree; only the parts that differ per chip live under src/arch/.
  • On x86 it currently runs on one CPU. Using several (SMP) is in development.
  • Sleep and wake are not there yet.

Ways to start: UEFI, BIOS, USB, install inside a file

Status (starting up): Ready

What it does — It starts in virtual machines (BIOS and UEFI) and from a USB stick, and in a window on the Mac.

How it works — A small loader starts first, puts the kernel and the app bundle in memory and hands over. It takes a few seconds from power-on to the desktop.

Technical details
  • There are separate loaders for UEFI and for old BIOS; USB sticks are written only with a dedicated tool.
  • The bundle loaded at boot has a size limit that the tests watch.

Install inside one file on your computer

Status: Planned

What it does — An install path that does not partition your disk: one file inside it becomes NanumOS's disk. To remove it, delete the file.

How it works — The install tool first shows what it will do and creates the file only after you confirm. The rest of the existing disk is left alone.

Storage and restore

Automatic saving

Status: Ready

What it does — Your documents and settings stay in their last saved state when power goes out or an app stops. Your data stays as it was after an update.

How it works — Changes are written to a record first and applied to their place afterwards. If it is cut off midway, the record is used to continue or to go back.

Technical details
  • A test that force-ends the process thirty times in a row kept the last save every time.
  • Proof against a real power cut is still only half done.

Restore points

Status: Planned

What it does — Keeps the state at important moments (before an update, for example) so you can go back to it if something goes wrong.

How it works — Planned as named points laid over the saving record, developed together with signed updates.

App isolation

Big apps as user programs

Status: Ready

What it does — Large apps such as photo retouching, video and office run in a space apart from the kernel. If one app stops or misbehaves, the rest of the screen and the OS keep running.

How it works — Like rooms in an apartment, each app has its own memory space. If it reaches into another room or the kernel's, the chip blocks it and only that app is ended.

Technical details
  • User space is mapped with separated write and execute rights (code is not writable, data is not executable), and faults, bad instructions and floating-point state are handled per app.
  • The kernel collects the memory and tasks of an ended app.

Networking

TCP/IP

Status: Ready

What it does — Implements the basic language of the internet (IP addresses, DHCP, DNS, TCP) so apps can use the network.

How it works — Pieces received from ethernet and virtual network devices are put back in order and handed to the app as one stream; lost pieces are sent again.

Wi-Fi

Status: Ready

What it does — Connects to a wireless router. The password is stored on the device and does not leave it.

How it works — It finds the router, performs the WPA handshake and connects. Only some wireless chips are supported, and a real-device check counts as "Ready" only when a person did it.

Encrypted connections (TLS client)

Status: Ready

What it does — Talks to websites and mail servers in encrypted form. Weather, news and update checks use this path.

How it works — It checks that the server's certificate can be trusted, then creates and exchanges the encryption keys.

Technical details
  • It uses a public crypto library (BearSSL, MIT) as it is, with our own glue on top. The client supports TLS 1.2 only.
  • The list of trusted certificate authorities is a dated bundle built into the image.

File sharing (SMB) client

Status: Ready

What it does — Opens shared folders on the same network (a NAS, another computer) so you can read and write them.

How it works — It talks to the share server in the SMB protocol, and reads and writes go over that conversation. The other direction, offering your own computer as a shared folder, is in trial on a development branch.

Status (offering a shared folder): In trial

Wire mesh network

Status: Ready

What it does — A private network that links your devices securely. Devices scattered between home, office and outside find and reach each other as if on one street.

How it works — Each device makes a key pair, and only devices that have exchanged public keys open an encrypted tunnel between them.

Devices

Sound, camera, touchpad, lid

Status (sound): Ready Status (camera): Ready Status (touchpad): Ready Status (lid): Ready

What it does — Recognises speakers and microphone, USB cameras, the finger gestures of a laptop touchpad, and closing and opening the lid.

How it works — Each device has a small driver that turns the hardware's language into one apps understand. There are many kinds of devices, so how much works differs per model; models that do not work are listed under "Known issues" in the manual.

Korean input

Korean in every text field

Status: Ready

What it does — Composes Korean wherever text is typed. The syllable being written is visible, backspace removes one letter part at a time, double final consonants work, and a click or Enter finishes the syllable.

How it works — Instead of building it per field, one shared input path is used by every field.

Vault

Password vault

Status: Ready

What it does — Keeps passwords and keys in one encrypted file. It opens only when you open it, and no other app or the assistant can read values on the quiet.

How it works — The file is in the widely used KDBX format, so other password apps can open it too. When an app asks for a value, an approval card appears first.

Technical details
  • KDBX4 format, key derivation with Argon2id, set so that opening still takes a reasonable time on phones and the web.

Virtual machines and compatibility

Hypervisor and virtual machines

Status: Ready

What it does — Runs another operating system as a guest inside NanumOS. The guest lives in its own box and cannot reach your data.

How it works — It uses the virtualisation feature of the chip to give the guest a virtual computer. Only one folder you choose is shared with it.

Linux program compatibility (in progress)

Status: In trial

What it does — A path to run existing Linux programs on NanumOS, to fill for now the apps NanumOS does not have.

How it works — It starts with a small Linux in a virtual machine whose window is placed on the NanumOS screen. It is still in trial.

Graphics acceleration (in progress)

Status: In trial

What it does — A path that borrows the power of the graphics chip to handle photos, video and screen effects faster.

How it works — The first step opens the path through the virtual graphics device a virtual machine provides; drivers for real chips come after.

NanumOS 0.1.8349 · 2026-11-16