First boot
This page describes what you see when NanumOS starts for the first time, what to set first (language, network, lock, time zone), and where your files are kept.
What you see at start
The first screen depends on where you started it.
| Started from | First screen |
|---|---|
| A laptop (USB stick, internal-disk file) | A text console. After the boot lines, Welcome to NanumOS and the prompt zeus@nanumos:~$ appear |
| NanumOS.app on a Mac | The desktop straight away. The network is already on |
| The browser demo | The desktop straight away |
A VM made with zeusos-vm | The console. Get in with zeusos-vm ssh NAME |
To open the desktop from the console, type gui. To get back to the console, type exit in the desktop's Terminal or press Ctrl+Alt+Q.
There is no login window at start. It opens as the user zeus from the beginning. Locking the screen is covered below in Lock screen and sign-in.
Language
The screen language is Korean or English. The easiest place to change it is Settings.
- On the very first start the welcome card has two buttons,
한국어andEnglish. Pressing one changes the whole screen at once. Once you pick, it does not ask again. - To change it later, go to Settings › General ›
Language & Region(or theLanguage & Regiontab at the top of Settings). - Every app, the top bar and its menus, the NanumOS menu, the lock screen and the search sheet change at once. Nothing restarts.
- The words shown while the computer starts (the boot lines) use the new language from the next start.
- The console commands
lang,lang koandlang enstill work.
The first language depends on the build. The default build is English, and some builds, such as the Mac window build, start in Korean. Hangul typing works in either language. See Korean input. How dates and times look, the first day of the week and the temperature unit are set under Region on the same screen. See Settings guide.
Network
Wired and phone tethering
- Type
net upat the console to get an address with DHCP. TheTurn Onbutton in Settings > General > Network does the same. - An Ethernet icon appears in the top bar. Click it to see the state, address and router. You can turn it off and on there.
- A phone plugged in over USB with tethering on works like a wired link.
- The Mac app and VMs have the network on already.
Wi-Fi
- The chip that works is the Intel AX201. With any other chip, there is no Wi-Fi icon.
- There is no on-screen window to type a Wi-Fi password yet. For the first connection, look at the networks with
wifi scanat the console, then connect withwifi join NAME. The password comes from a value put on the USB stick beforehand, or from a vault entry (wifi join NAME vault=ENTRY). - After it connects, type
wifi saveto remember the network. The password itself is not stored, only the value needed to connect, and only the administrator can read that file. Where saving is on, it connects by itself from the next boot. wifi knownlists saved networks andwifi forget NAMEremoves one.- Click the Wi-Fi icon in the top bar to see the state, the name (SSID) and the address. It has
Turn Wi-Fi OffandTurn Wi-Fi On. - If wired is already on, Wi-Fi joining does not cut it.
The welcome tips
When the desktop first opens, a welcome card appears in the middle once per boot. It says:
- Click an app in the Dock at the bottom to open it. The top bar names the app you are using and shows its menus.
- Close a window with the red button at its top left.
- The bolt at the top left: sleep, restart, shut down, lock.
- Keys are optional. Alt (option on a Mac) with
Alt+1..9opens an app,Alt+Tabswitches apps, andAlt+F4closes one. - Every shortcut is on
Super+/.F1is help for the app in front. - In the Mac window the mouse is never captured. Hold the command key and press Q to quit.
The card is in the language you picked. If no language has been picked yet, the card also has the buttons 한국어 and English. Press OK or any key to close it. It does not come back during the same boot. The shortcut table is also on the Shortcuts page.
Lock screen and sign-in
- There is no sign-in screen. It opens as
zeusright away. - Lock the screen with
Super+L, with Lock Screen in the bolt menu at the top left, or with Lock Screen in the power button menu at the far right. - The lock screen shows a big clock and the date over the wallpaper, and a card with an input field. The card text is in English.
- The key is one of two things: the PIN you set in Settings, or the account password if you gave the account one. If neither exists, the card says
no PIN setandEnteralone opens it. - A wrong try blocks keys for 1 second, and from the third try for 5 seconds. Keys typed while it waits are dropped.
- A PIN can hold only Latin letters, digits and symbols. It cannot hold Hangul.
To set a PIN:
- In Settings > General > Lock PIN, press
Set PIN…. - If one exists, type the current PIN. The new PIN is 4 characters or more, typed twice. Leaving the new PIN empty removes the PIN.
- In Lock after, choose Never, 1, 2, 5, 10, 15, 30 or 60 min. The screen then locks by itself when there is no input for that long. Locking by itself happens only when a PIN or an account password exists.
Sleep blanks the screen. A key, a click or a mouse move wakes it. If a PIN is set, the lock screen follows. It only blanks the screen. It is not a power-saving sleep.
A PIN is a screen lock, not disk protection. Someone who can read the files can try PINs.
Time zone
- The first time zone follows the device's system zone. If nothing was set, it is Korea Standard Time (UTC+9).
- To change it, open Settings > General > Time zone and step by one hour with the left and right buttons.
- The chosen value is used by the clock in the top bar, today in Calendar, and the Clock app. The value is in whole hours, so you must change it yourself for daylight saving.
- The top-bar clock reads
10월 31일 (토) 오후 1:05in Korean andSat 31 Oct 13:05in English.
Where your files go
/tmp is never saved. It is empty at every start.
Whether files survive power-off depends on where you started it.
| Started from | Where files are kept |
|---|---|
| A USB stick | The stick's storage area, if you chose one when making the stick. Without one, nothing is kept |
| Internal-disk file install | Inside the file /zeusos/disk.img |
| NanumOS.app on a Mac | Application Support/NanumOS/home.raw in your user Library |
A VM made with zeusos-vm | The 64 MiB work disk each VM has of its own |
| The browser demo | Nothing is kept. Everything is deleted when it ends |
Where saving is on, you do not need a save command. It saves by itself after about 2 seconds of quiet, and at the latest 10 seconds after the first change even if you keep working. It also saves first when you shut down or restart. Updating to a new version keeps the files in the storage area. The vault file, mail and saved Wi-Fi networks are stored in the same place.
A single name can be up to 255 bytes, as on an ordinary computer (about 85 Hangul syllables). One file can be up to 64 GB. In the Mac app the storage area can use as much as the Mac has free.
Not yet
- There is no Korean 3-Set (세벌식) layout. Hangul typing is 2-Set only.
- There is no on-screen window to type a password and join Wi-Fi.
- There is no sign-in screen or user chooser.
- There is no one-time setup guide (wizard) after install. The welcome card appears at every boot.
- Sleep only blanks the screen. There is no power-saving sleep.
- A stick made without a storage area keeps no files.
NanumOS 0.1.8349 · 2026-11-16