NanumOS

File Sharing — open one folder to Macs, Windows PCs and Linux machines on your network

What it is

File Sharing lets Macs, Windows PCs and Linux computers on the same network open one folder of this computer. Think of putting a guest door on one room of a house and letting in only people who know the key (the password). Every other room stays locked.

Off is the default. Before you turn it on no port is open, and after a restart it is off again. It opens only when you choose a folder, a name and a password and turn it on yourself.

What to do now: to use it, open Settings › File Sharing, choose a folder, type a password and turn the switch on. If you do not need it, do nothing.

Basics — SMB, the share name, the password

What SMB is. The common language Macs, Windows, Linux and NAS boxes use to share folders. NanumOS speaks only its modern version (SMB 3). The old, risky SMB 1 and 2.x are not spoken.

What the share name is. The name other computers see for this folder. It need not match the folder's name.

The password is separate from your login password. The sharing password has 8 or more characters and is typed once, when you turn sharing on. It is not saved to a file, and it is gone when you turn sharing off or restart. The user name is the name of the account you are signed in as.

How to use it

  1. Open Settings › File Sharing.
  2. Press "Choose…" and pick a folder inside your home folder. The home folder itself and hidden folders starting with . (.ssh, .config ...) cannot be chosen.
  3. Type a share name and a password (8 characters or more).
  4. Choose "Read only" or "Read and write". With read only the other computer can look at the folder and copy from it, but not change or delete anything.
  5. Choose "Open to". "This network" lets in only computers on the same network as this one (behind the same router); "Wire" lets in only your own devices joined by Wire. The internet cannot reach it.
  6. Turn the switch on. The screen shows the addresses to open from the other computer. To turn it off, press the switch again — the port closes at once and connected computers are disconnected.

Opening it from another computer (use the address the screen shows)

Sign in with the user name and password above. There is no guest access.

In the terminal: smbd shows the state, smbd on <folder> <name> [user=NAME] [ro|rw] [lan|wire] turns it on (the password is asked with echo off), smbd off turns it off.

In the Security app: its open doors and permissions list "File sharing — port 445, the network you chose only", and you can turn it off there too.

How it works

When you turn it on, NanumOS opens port 445 and waits. When someone connects, it first looks at where they come from. A connection from outside the network you chose (the internet, itself, another network) is dropped at once. Then it checks the user name and password, and if they match it reads and writes files in the folder with only the rights of the person who turned sharing on — as much as that person could do at the console.

Why it is safe. The password itself is stored nowhere; only the fingerprint (hash) needed to check it sits in memory and is wiped when you turn sharing off. Every request is signed so it cannot be forged, and the content is encrypted when the other computer can. After 10 wrong passwords that address waits a minute. Paths that climb out of the folder (..) are refused.

Try it yourself: turn sharing on, then connect from another computer with a wrong password. It is refused, and the "wrong passwords" count in Settings › File Sharing goes up.

Technical details
  • Protocol: SMB 3.0 / 3.0.2 / 3.1.1 (NTLMv2 sign-in, signing AES-GMAC or AES-CMAC required, AES-128-GCM or CCM encryption whenever the client can). No SMB1, no 2.x, no guest, no NTLMv1. Up to 3 connections at once.
  • Windows clients have not yet been checked on a real Windows PC (the same conversation was tested with smbclient's SMB 3).
  • Not there: Kerberos and domains, locks and oplocks, change notifications, finding the name on the network (mDNS announcements, NetBIOS), case-insensitive names (case counts, as on Linux), file names over 31 bytes (about 10 Korean letters), recycle bin and previous versions.
  • Check: the "파일 공유" line of os_check grades the share_* numbers of /proc/smb (on, connections, wrong passwords, turned-away connections).

NanumOS 0.1.8349 · 2026-11-16