Remote access
What it is
Going from this computer into another one, and letting another computer come into this one, in one place — the Remote Desktop app. It is like looking through someone's window while holding their mouse and keyboard. There are two ways: View Screen (the whole screen) and Terminal (typed commands).
The app has two paths.
- Go into another device — NanumOS computers on the same network, your devices on your own network (Wire), this computer's VMs, your servers and recent places show up by themselves. Press a device card once to view its screen. For a terminal, select it and press
Ctrl+T. - Come into this device — the address another device uses to reach this screen, the one-time code, a QR, on/off, who is connected and Disconnect.
What to do now: open Remote Desktop and press the device card you want.
How to use it
Your other device (NanumOS) — no code
- Press the device's card once. If it is your device, its screen opens with no code and no password.
- The first time only: if that device does not know this one yet, its screen shows "… wants to see this screen". Always Allow there means it never asks again (Allow Once is for this time). If nobody is at that screen, type the code it shows here once instead (with "It is my device: next time without a code" on).
- The other screen shows in the window. Korean types through this computer's Han/Eng key; copy and paste work both ways.
Someone else's NanumOS
Pressing its card shows a question on that screen. When that person presses Allow Once you are in; Don't Allow, or no answer in 60 seconds, keeps you out. You can also type the code they read to you.
Your devices are listed in Settings › Sharing (Remote Desktop › Come into this device), "My devices (no code)", and Forget them removes them. At the console: remote mine · remote forget N.
From Mac Screen Sharing into NanumOS
- On NanumOS, open Remote Desktop › Come into this device and note the same-network address and pairing code.
- On the Mac, choose Finder › Go › Connect to Server and enter
vnc://address:5900. - When Screen Sharing asks for a password, enter the code shown on NanumOS. It changes after one successful login. To keep a password, set one in NanumOS sharing settings.
A terminal into Linux, a laptop, a server
- In This computer's key, for terminals (ssh) under the list press Make Key (once), then Copy.
A place that is not in the list
- A Mac: turn on System Settings › General › Sharing › Screen Sharing. On the first connection, enter Mac login name and Mac login password in one window. If rejected, try new values in that same window.
- Ubuntu desktop (GNOME): its built-in remote desktop speaks RDP, so View Screen does not work yet — use Terminal, or turn on VNC there (Technical details).
From another device into this one
- New Code — the current code stops working at once and a new one is made.
- To come in from outside the home, Join my network (Wire)… joins your own Wire (a one-time invitation). Then any of your Wire devices reaches this screen and its terminal.
- Inside the Mac window the Mac wraps NanumOS in a private virtual network, so other computers cannot reach it directly. Start the window with "come in through the Mac" (Technical details) and the card says "Inside the Mac window, come in through the Mac's address …:5900".
- Someone inside this screen: an orange mark in the top bar (a click disconnects everyone). This computer inside another one: a blue mark (a click brings that window).
Talk to Zeus from your phone or another app (Connected devices)
- Settings › Sharing › Connected devices — the door through which an app on your phone talks with the Zeus of this NanumOS, in the same conversation. It is not a new chat: the one you had on the desktop continues.
- Press "Add a device" and a one-time code, good for 10 minutes, shows on this screen only. Type it into the phone app and the two are paired. A code works once.
- "Disconnect" on a row cuts that device at once, and it cannot come back (to use it again, pair it with a new code).
- What the phone asks for that deletes, sends or overwrites shows here as an [Allow] card. Saying "yes" on the phone is not an approval. Light things such as opening Notepad just happen.
- Pair a phone (QR): with "From other devices" on, press "Add a device": a QR appears next to the code. Scan it with the ZEUS app — the address, the one-time code and the fingerprint go in together; the phone then talks only to a door with that fingerprint and keeps its key in its own Keychain. No password is in the QR — the code ends after 10 minutes or one use.
- One conversation, every screen: what you say on the phone and the answer show in this computer's Zeus app as the same conversation, and a question typed in that conversation in the Zeus app shows on the connected phones with its answer too (the phone does not read it aloud).
- When you talk on the phone, the phone hears and the phone reads (the sound never leaves it; only text comes through this door). Other screens on the same conversation (a second phone, say) see the words and the answer too, and an approval card is decided once, on whichever screen.
Try it now
- On one, Remote Desktop › Come into this device — note the address and the code.
- On the other, Go into another device — View Screen on the row that showed up (or Connect to Address… with that address) → the code.
- Terminal: Copy the key in the box below → on the other side
ssh-authorize+ paste in its Terminal →sshd &→ Terminal on the row.
If it does not work
- If Mac Screen Sharing stays on "Connecting…" or says it cannot connect, check that Come into this device is on (it is off by default; turn it on in Settings › Sharing). Enter the current code if it changed. Probe connections that have not logged in close after 20 seconds; only two logged-in viewers take viewer seats.
- If the list inside the Mac app shows only the Mac itself, NanumOS is inside the Mac's virtual network. Use Connect to Address… with the other device's home-network address; the guest can connect out through NAT. Automatic host-assisted discovery is not available yet.
- To reach NanumOS inside the Mac app from another device, start the window with
--remote-infor now. There is no switch to enable it while the app is running yet.
How it works
- The list fills itself: it asks the network once "any NanumOS sharing its screen here?" (only a NanumOS whose sharing is on answers) and reads network neighbours, Wire, the VM Manager and your servers file. It never connects anywhere first.
- The terminal key is made inside this NanumOS and stays here. Only the public key is given to the other computer.
- Ask the assistant "go into the work server": it picks from the list and goes in only after you press [Allow]. It never sees codes or passwords.
Technical details
- Sessions:
/tmp/remote-now(names and addresses only) → the check row "원격 접속" (in and out together). - "Cmd keys: to the other computer" sends Cmd+Q, W, Tab too to the other side (Command on a Mac, Ctrl elsewhere); off, they are this computer's shortcuts.
- Pairing QR:
zeusdoor:1?a=<this machine>:7311&c=<code>&f=<fingerprint>— drawn only while the code lives and wiped with it (in no log or file). The phone sends its first byte only if the certificate's SHA-256 equals f. A turn's messages go to every connected screen; the screens that did not say it getuser{text,src,by}first.
NanumOS 0.1.8349 · 2026-11-16