Welcome to CubeOS - an open-source operating system for self-hosted ARM64 servers.
CubeOS transforms single-board computers like Raspberry Pi into powerful, easy-to-manage home servers. It provides a beautiful web dashboard for managing services, network settings, and system resources without needing terminal access.
- Getting Started - First-time setup from flash to first app
- Network Modes - OFFLINE, Ethernet, and WiFi connectivity
- Backup and Restore - Backups, encryption, and recovery
- FAQ - Frequently asked questions
- Dashboard Guide - Using the web interface
- App Store Guide - Browsing, installing, and managing apps
- Services Guide - Managing applications
- Network Guide - WiFi, DHCP, and DNS configuration details
- Troubleshooting - Common issues and solutions
- API Reference - REST API documentation
- Developer Guide - Building from source, contributing, custom apps
| Service | URL | Default Credentials |
|---|---|---|
| Dashboard | http://cubeos.cube | admin / cubeos |
| Pi-hole | http://pihole.cubeos.cube/admin | cubeos |
| NPM | http://npm.cubeos.cube | cubeos@cubeos.app / cubeos123 |
| Logs | http://logs.cubeos.cube | (no auth) |
- Raspberry Pi 4 or 5 (4GB+ RAM recommended)
- 16GB+ microSD card or USB storage
- Power supply (official recommended)
- Ethernet cable (optional, has WiFi AP)
CubeOS operates on the 10.42.24.0/24 subnet with the domain cubeos.cube.
| Setting | Value |
|---|---|
| Gateway | 10.42.24.1 |
| DNS | 10.42.24.1 (Pi-hole) |
| DHCP Range | 10.42.24.10 - 10.42.24.250 |
| Domain | cubeos.cube |
Architecture documentation is in architecture/:
- GitHub: https://github.com/cubeos-app
- Documentation: https://docs.cubeos.app