Build It

Going Headless: Running Without a Monitor

Once your mini PC is set up, it doesn't need a screen, keyboard, or mouse permanently attached. Here's how to run it headless and reach it over SSH.

12 minute read

Why go headless

Once Ollama and Open WebUI are running, you're interacting with your mini PC through a browser tab, not the machine itself. There's no real reason to keep a monitor, keyboard, and mouse permanently attached to something that's really just serving models over your network now.

Going headless means the mini PC can live somewhere out of the way - a closet, a shelf, wherever it's quiet - and you manage it entirely from your everyday computer over SSH, a secure command-line connection.

Enabling SSH

On most Linux mini PC setups, SSH is either already running or one command away:

sudo systemctl enable --now ssh

On Mac, it's a checkbox: System Settings → General → Sharing → Remote Login. Turn it on.

Before you disconnect the monitor, find the machine's local IP address - you'll need it to connect:

hostname -I

Write it down or set a static IP. Home routers usually keep the same address for a device, but it can change after a restart or long time offline. A static IP or a router-level reservation for this machine saves a headache later.

Connecting from another machine

From your everyday computer's terminal:

ssh username@192.168.1.XXX

Replace the username and IP with your mini PC's actual values. The first connection will ask you to confirm the machine's identity - type yes and continue.

From here, you can now safely unplug the monitor, keyboard, and mouse. Everything - checking on Ollama, restarting Open WebUI's container, installing updates - happens through this SSH session instead.

You're headless: the mini PC just became a proper little server, managed the same way real servers are - remotely, over a secure connection, no screen required.

What actually goes wrong

Connection refused when you try to SSH in

This almost always means the SSH service isn't actually running yet, or a firewall is blocking it. Reconnect the monitor briefly and confirm the service status:

sudo systemctl status ssh

The IP address changed and you can't find the machine

Check your router's connected devices list - most home routers show a page of everything currently on the network, usually by device name. This is also the moment to set up that static IP reservation if you haven't already.

You want SSH access from outside your home network too

That's a real, common want - but it's a meaningfully bigger security decision than anything in this guide, since it means something is reachable from the internet, not just your home network. See Locking Down Your Local AI Setup before opening anything up that way.

Common questions

Do I lose the ability to use a monitor later if I go headless?

No. Plugging a monitor back in works exactly like normal any time you want it. Headless just means you are not required to have one connected.

Can I do this on Windows too?

Yes, Windows has built-in OpenSSH server support you can enable in Settings, though headless setups are more common on Linux mini PCs specifically.

Go deeper

This guide covers one solid path. Here's where to go if you want something different.

r/homelab A whole community built around exactly this kind of quiet, out-of-the-way server setup. The Local Lab Covers remote-access setups for local AI beyond just SSH, if you want more options.

Written from hands-on security operations experience. More about this site →