Troubleshooting
Common symptoms and fixes. Try them from the top.
It does not start
- If you start from a USB stick, pick the NanumOS stick (usually named
USB HDD) in the firmware boot menu. - If you did a trial start from the NanumOS entry on an installed PC, that start is a one-time thing. The next start goes back to the existing operating system. Pick the NanumOS entry again to return.
- If the install tool shows a line starting with
REFUSED:, nothing was written. Read the disk, free space and boot order thatplanshows once more. - If you just updated, wait. If the new release does not come up, the next start goes back to the old release by itself. See Storage and updates.
- If it hangs for a long time and the screen does not change, turn it off and on again. An auto-save disk comes back as either the old or the new state if the power goes out during a save.
No network or Wi-Fi
- In
Settings,General, check thatNetworksaysOn. If it saysOff, pressTurn On. - For a wired connection (USB LAN), just plug it in. If it does not connect, type
net statusin the terminal to see whether there is an address. To see the whole machine at a glance, typedescribe -hin the terminal (system, memory, storage, sound, devices, network, processes and programs in plain words). - Wi-Fi works only on an Intel AX201 wireless device for now. In the terminal, in order:
wifi hwfinds the device.wifi scanlooks for networks around you.wifi join NAMEconnects.- While connected, type
wifi saveand it connects by itself at the next start. - The other
wificommands:
| Command | What it does |
|---|---|
wifi status | Shows the connection state. |
wifi known | Lists the saved networks. |
wifi forget NAME | Deletes a saved network. |
wifi auto on, wifi auto off | Decides whether it connects by itself at start. |
wifi country CODE | Sets the country code. wifi country auto is automatic. |
wifi stop | Stops Wi-Fi. |
If a network is saved and you have not turned auto-connect off, it tries to connect at start. If Wi-Fi fails to connect, an already connected USB LAN is not dropped.
wifi save does not store the password, only the connection key. That key can still join the network, so the file is readable only by root.
No sound
- In
Settings,General, look atVolume. If it saysnot available (no audio driver yet), that device cannot play sound yet. - Check that the slider is not at 0 and that the keyboard's mute key is not on.
- Radio and video need the network to be on.
Several sounds play at once, like on any computer: the radio, a video in the Browser and the assistant's voice are mixed together, each at its own volume, so one never silences another. If a sound stutters, the computer was too busy for a moment; ask the assistant to check the system (the Sound row says how many times it broke up).
Technical details
NanumOS mixes up to 8 players into one 48 kHz output in 10 ms steps, keeping about 80 ms ready ahead of the speaker. audio mix in the Terminal and /proc/sound list the players, their rates and the gaps (underruns).
It is slow
- In the
Tasksapp, find a program that has been running a long time and end it. - In the
Systemapp, look at the free memory and the drawing time. - In
Settings,General, loweringDisplay scaleto1xreduces how much is drawn. - Running in a virtual machine (QEMU) is slower than real hardware.
Locked out
- After a wrong PIN, input is blocked for 1 second; after three wrong tries, for 5 seconds. Wait and try again.
- On a device with user accounts, the lock screen asks for the account password instead of a PIN.
- A lock screen with no PIN opens with just
Enter. - If nothing seems to respond, it may be
Sleep. Press a key or move the mouse (with a PIN, the lock screen comes first).
The vault will not open
- Type the master password exactly. A password set when creating a new vault has at least 8 characters.
- There is no way to recover a forgotten master password today.
- See Vault for more.
Keyboard and Hangul do not work
- Look at the top right of the screen:
가orA.Ameans you are typing Latin letters. - Switch between Hangul and Latin with
Shift+Space, the rightAlt, or the Han/Eng key. - Hangul input is the two-set (dubeolsik) layout.
- If you get Hangul on a Latin layout or the other way round, switch once more with the keys above.
- All keys are on the Shortcuts page.
The display looks wrong
- If text or pictures are too small or too large, change
Display scale(General) andText size(Fonts) inSettings. 2xcan be picked only when the screen is at least 1600 pixels wide.- If only the terminal text is too small or large, change
Terminal text sizein theTerminalpane. - To leave the desktop and return to the console, press
Ctrl+Alt+Q. In the console,lang koorlang enchanges the language. - Each pane is described in the Settings guide.
Files are not saved
- Type
dfin the console to see the state.FULL: next save failsmeans there is no room. Delete files. - If
storagesays the mode isnone, there is no persist area. Files are lost when you turn off. - Try
syncto save right now. - If you see
Could not save <path>after changing a setting, the cause is the same. - If
cat /proc/storagesaysstate=retrying, the disk did not answer for a moment. What you saved before is safe and NanumOS saves again by itself. Leave the computer on and wait a minute or two. - See Storage and updates for more.
Still stuck
Write down the screen text exactly as it appeared when the problem happened. In the console (Ctrl+Alt+Q), type version to get the release number and report it too. Common questions are on the FAQ page.
Where are the logs?
What the computer says to itself (sound ran dry, the disk was slow, a network address arrived) does not appear on the screen or in the Terminal; it is written to log files. A quiet Terminal is normal.
- System Information → Overview → View Log shows the latest lines in plain view (newest at the bottom).
- In the Terminal:
cat /var/log/messages(each line starts with the date and time) anddmesg(time since boot). - When
/var/log/messagespasses 256 KiB it becomes/var/log/messages.0and a new file starts. - The diagnostics (os_check) row "기록 파일" reports the file's line count and last line.
What to do now: when something looks wrong, open View Log and read the last few lines.
NanumOS 0.1.8349 · 2026-11-16