🖥 Bare-Metal x86_64 OS

SynapseOS
Technical Documentation

Complete technical reference for SynapseOS — a bare-metal x86_64 operating system with a graphical desktop, built entirely from scratch without any host OS runtime. Every component, from the bootloader handoff to the TLS-secured browser, is documented here.

Get Started → 🚀 Marketing Page Developer Guide API Reference
Illustration of a desktop computer running SynapseOS, showing an open browser window, a terminal window, and a taskbar
11Documentation Sections
x86_64Target Architecture
Ring 0Execution Model
192 MBKernel Heap
TLS 1.2Secure Networking
How It's Put Together
One large room with different work areas side by side and no walls between them, representing how every part of SynapseOS lives inside a single program
Everything — the desktop, the files, the network, the devices — lives inside one single program, with nothing separating them.
Your Reading Path
A winding road with four milestones: Start Here, Learn the Basics, See It Run, and Go Deeper
Follow the guide in order, or jump straight to whatever you're curious about.
What's Inside This Guide
01
Introduction
What SynapseOS is, and why it was built this way
02
How It All Fits Together
A simple map of the system's moving parts
03
Starting Up
What happens between pressing power and seeing the desktop
04
The Engine Room
The part that keeps everything running smoothly
05
Files & Storage
Where your files live and how they stay organized
06
Getting Online
How the system connects to the internet
07
Keeping You Safe
What's protected, what isn't, and why
08
What You See and Use
The desktop, browser, terminal, and everyday tools
09
Building It Yourself
For the curious: how to compile and run it yourself
10
Everyday Use
Settings, accounts, and fixing common problems
11
Good to Know
A friendly glossary and answers to common questions