Documentation
Guides and references for HeadlessOS, the free, open-source desktop for your Linux servers.
What is HeadlessOS?
Section titled “What is HeadlessOS?”HeadlessOS shows your Linux servers as a desktop, with windows, a dock and apps for files, Docker, services and more. It runs on your own computer and connects over SSH, so nothing is installed on the server.
Start here
Section titled “Start here” Quick Start Install the app and connect your first server. Connect a server Passwords, SSH keys, and what a server needs.
Explore the apps
Section titled “Explore the apps” Dashboard Live CPU, memory, disk and network. File Explorer Browse, edit and upload files over SFTP. Docker Containers, images, and the files inside them. Server Admin Users, firewall, packages, logs and cron.
Use AI, if you want to
Section titled “Use AI, if you want to”AI is optional, and every app works without it.
Set up AI OpenAI, Claude, or a local model through Ollama. Safety and approvals What agents can do, and what waits for you.