NanumOS

Troubleshooting

Common symptoms and fixes. Try them from the top.

It does not start

  1. If you start from a USB stick, pick the NanumOS stick (usually named USB HDD) in the firmware boot menu.
  2. 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.
  3. If the install tool shows a line starting with REFUSED:, nothing was written. Read the disk, free space and boot order that plan shows once more.
  4. 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.
  5. 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

  1. In Settings, General, check that Network says On. If it says Off, press Turn On.
  2. For a wired connection (USB LAN), just plug it in. If it does not connect, type net status in the terminal to see whether there is an address. To see the whole machine at a glance, type describe -h in the terminal (system, memory, storage, sound, devices, network, processes and programs in plain words).
  3. Wi-Fi works only on an Intel AX201 wireless device for now. In the terminal, in order:
  4. wifi hw finds the device.
  5. wifi scan looks for networks around you.
  6. wifi join NAME connects.
  7. While connected, type wifi save and it connects by itself at the next start.
  8. The other wifi commands:
CommandWhat it does
wifi statusShows the connection state.
wifi knownLists the saved networks.
wifi forget NAMEDeletes a saved network.
wifi auto on, wifi auto offDecides whether it connects by itself at start.
wifi country CODESets the country code. wifi country auto is automatic.
wifi stopStops 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

  1. In Settings, General, look at Volume. If it says not available (no audio driver yet), that device cannot play sound yet.
  2. Check that the slider is not at 0 and that the keyboard's mute key is not on.
  3. 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

  1. In the Tasks app, find a program that has been running a long time and end it.
  2. In the System app, look at the free memory and the drawing time.
  3. In Settings, General, lowering Display scale to 1x reduces how much is drawn.
  4. Running in a virtual machine (QEMU) is slower than real hardware.

Locked out

The vault will not open

Keyboard and Hangul do not work

  1. Look at the top right of the screen: 가 or A. A means you are typing Latin letters.
  2. Switch between Hangul and Latin with Shift+Space, the right Alt, or the Han/Eng key.
  3. Hangul input is the two-set (dubeolsik) layout.
  4. If you get Hangul on a Latin layout or the other way round, switch once more with the keys above.
  5. All keys are on the Shortcuts page.

The display looks wrong

Files are not saved

  1. Type df in the console to see the state. FULL: next save fails means there is no room. Delete files.
  2. If storage says the mode is none, there is no persist area. Files are lost when you turn off.
  3. Try sync to save right now.
  4. If you see Could not save <path> after changing a setting, the cause is the same.
  5. If cat /proc/storage says state=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.
  6. 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.

What to do now: when something looks wrong, open View Log and read the last few lines.

NanumOS 0.1.8349 · 2026-11-16