Built for people who want a compact, approachable, and capable server system.
CapOS combines low resource usage, a browser-first management experience, and room to grow from simple setups to serious self-hosted workloads.
Website · Download Releases · Package Repository · Quick Start · Documentation
Maintained by the FWERKOR Team, especially Castronaut.
CapOS is an open-source server operating system focused on clarity, efficiency, and day-to-day usability. It is designed for homelabs, learning environments, edge devices, and compact servers where a full management workflow matters just as much as raw functionality.
Instead of feeling like a stripped-down build environment, CapOS aims to feel like a complete server platform from the moment it boots: easy to access, easy to manage, and flexible enough to expand as your needs change.
|
Runs with a small footprint and works well across a broad range of hardware, from compact devices to full PCs. |
Manage the system from a browser through a more visual, approachable interface for settings, packages, and system status. |
|
Start simple, then grow into richer services and more advanced workloads without leaving the same platform. |
A clean command-line workflow and simplified management flow help new users get productive quickly. |
|
Built on a mature Linux foundation with a strong focus on dependable behavior and practical security defaults. |
Released under GPL-2.0 and open to community contributions, improvements, and ecosystem growth. |
| Area | Default |
|---|---|
| Web panel | 2000/tcp (HTTP), 2020/tcp (HTTPS) |
| Remote access | 23/tcp for Telnet before a root password is set, 22/tcp for SSH |
| Network mode | Uses DHCP and DHCPv6 by default |
| Firewall | Accepts inbound traffic from LAN; rejects inbound traffic from WAN except 2000/tcp and 2020/tcp |
More usage details are available in the User Guide.
| Resource | Link |
|---|---|
| Releases | GitHub Releases |
| Package repository | repo.capos.top |
| Quick start | Wiki Quick Start Guide |
CapOS welcomes contributors, maintainers, and application developers. If you want to improve the platform or build apps around it, the best starting points are below.
| Topic | Link |
|---|---|
| Developer guide | CapOS Developer Guide |
| App development | CAPP Development Guide |
| Example project | capp-helloworld |
To make repository access easier across different regions, CapOS provides:
- Primary repository: https://github.com/fwerkor/capos
- Read-only mirror for users in Mainland China: https://gitcode.com/fwerkor/capos
Issues, discussions, and pull requests should be submitted through the GitHub primary repository.
To build your own firmware, use a GNU/Linux, BSD, or macOS system with a case-sensitive filesystem. Cygwin is not supported.
Required tools vary by distribution, but the typical dependency set includes:
binutils bzip2 diff find flex gawk gcc-6+ getopt grep install libc-dev libz-dev
make4.1+ perl python3.7+ rsync subversion unzip which
An automatic dependency installer is available at scripts/auto_install_dependencies.sh, but manual installation is recommended if the script does not match your environment.
Build steps:
- Run
bash ./scripts/auto_install_dependencies.shto install dependencies. - Run
make menuconfigto choose the target platform, toolchain, and packages. - Run
maketo build the firmware.
Use a non-root user for builds.
- GitHub Issues for bug reports and feature requests
- GitHub Discussions for questions, ideas, and community conversations
CapOS is licensed under GPL-2.0.
