Reviewed-on: #1
Overview · Docs Source · Applications · CLI · Daemon
The modern internet built on public clouds is increasingly threatening your personal data privacy. As reliance on services like ChatGPT, Midjourney, and Facebook grows, so does the risk to your digital autonomy. Your data lives on their servers, subject to their terms, tracking, and potential censorship.
It's time for a change.
beOS Pro is a local-first server platform for running your own applications, storage, AI workloads, and internal services on hardware you control.
This fork is being refactored to remove mandatory dependency on vendor-managed activation, DNS, CDN, and remote control-plane services. The goal is straightforward: install on bare metal or on top of an existing Linux server, finish setup locally, and operate it without connecting to any external beOS-operated infrastructure unless you explicitly configure optional providers.
🌟 Star us to receive instant notifications about new releases and updates.
Architecture
beOS Pro is structured as a host bootstrap layer, a Kubernetes orchestration layer, and a containerized platform/application layer.
For the current architecture source, start with docs/developer/concepts/system-architecture.md.
🔍 How is beOS Pro different from a traditional NAS?
beOS Pro focuses on running a full self-hosted server platform, not just network-attached storage. It combines host bootstrap, Kubernetes orchestration, apps, storage, and AI services in one stack.
Features
beOS Pro offers a wide array of features designed to enhance security, ease of use, and development flexibility:
- Enterprise-grade security: Simplified network configuration using Tailscale, Headscale, Cloudflare Tunnel, and FRP.
- Secure and permissionless application ecosystem: Sandboxing ensures application isolation and security.
- Unified file system and database: Automated scaling, backups, and high availability.
- Single sign-on: Log in once to access all applications within the platform with a shared authentication service.
- AI capabilities: Comprehensive solution for GPU management, local AI model hosting, and private knowledge bases while maintaining data privacy.
- Built-in applications: Includes file manager, sync drive, vault, reader, app market, settings, and dashboard.
- Seamless anywhere access: Access your devices from anywhere using dedicated clients for mobile, desktop, and browsers.
- Development tools: Comprehensive development tools for effortless application development and porting.
The repository includes a full application suite covering desktop shell, files, vault, market, settings, dashboard, studio, and control hub.
Key use cases
Here is where beOS Pro is a strong fit:
🤖 Edge AI: Run cutting-edge open AI models locally, including large language models, computer vision, and speech recognition. Create private AI services tailored to your data for enhanced functionality and privacy.
📊 Personal data repository: Securely store, sync, and manage your important files, photos, and documents across devices and locations.
🚀 Self-hosted workspace: Build a free collaborative workspace for your team using secure, open-source SaaS alternatives.
🎥 Private media server: Host your own streaming services with your personal media collections.
🏡 Smart Home Hub: Create a central control point for your IoT devices and home automation.
🤝 User-owned publishing and communities: Easily install apps such as Mastodon, Ghost, and WordPress without depending on third-party platforms.
📚 Learning platform: Explore self-hosting, container orchestration, and cloud technologies hands-on.
Getting started
System compatibility
beOS Pro has been tested and verified on the following Linux platforms:
- Ubuntu 24.04 LTS or later
- Debian 11 or later
Set up beOS Pro
To get started, review the install and architecture sources in this repository, especially docs/manual/get-started/ and docs/developer/concepts/system-architecture.md.
Project navigation
This section lists the main directories in the repository:
apps: Contains the code for the built-in applications and user shell.cli: Contains the code forbeos-cli, the command-line interface tool.daemon: Contains the code forbeosd, the system daemon process.docs: Contains documentation for the project.framework: Contains the core system services.infrastructure: Contains code related to infrastructure components such as computing, storage, networking, and GPUs.platform: Contains code for cloud-native components like databases and message queues.vendor: Contains code from third-party hardware vendors.
Contributing to beOS Pro
We are welcoming contributions in any form:
-
If you want to develop your own applications on beOS Pro, start with the code in
apps/,framework/, andplatform/. -
If you want to help improve beOS Pro, open issues and pull requests in this fork.
Community & contact
- Use your fork's issue tracker and discussion channels for support and development planning.
Special thanks
beOS Pro incorporates numerous third-party open source projects, including Kubernetes, KubeSphere, K3s, JuiceFS, MinIO, Envoy, Authelia, Infisical, Seafile, Headscale, Tailscale, Restic, Velero, and many others used throughout this stack.