Open source
Faros open source
The Faros control plane, portal, and providers are developed in public under Apache 2.0. You can inspect the architecture, run the platform on infrastructure you control, and extend it through the same provider contract used in the repository.
- Apache 2.0
- Self-hostable
- Provider-extensible
- Developed in public
What is open
The platform is visible from kernel to capability.
The hosted service is a way to consume Faros, not a separate product with a hidden control plane. The public repository contains the platform and the providers documented on this site.
Control plane
Inspect workspace and identity boundaries
Follow how the hub addresses logical workspaces, authenticates requests, and carries workspace identity to APIs and provider backends.
Read the architectureCapabilities
Inspect shipping providers
Review provider resources, controllers, portal surfaces, and MCP tools for edges, infrastructure, code, agents, App Studio, fleet query, and more.
Browse the catalogExtension model
Build with the same provider contract
A custom provider uses CatalogEntry registration and the same optional API, controller, backend, portal, and MCP integration points.
Study provider anatomyOperate it yourself
Choose the infrastructure and access model.
A self-hosted Faros hub runs on Kubernetes. The deployment guides separate hub installation from ingress and authentication so you can make those choices explicitly.
Install
Deploy with Helm
Create a cluster, configure values, install the chart, wait for the hub, and then move from the local path to a production-oriented deployment.
Open the Helm guideExpose
Choose ingress and TLS
Use port forwarding for local work or select a private mesh, cloud load balancer, ingress controller, or Cloudflare Tunnel for remote access.
Compare ingress optionsAuthenticate
Configure identity
Use static tokens for a simple deployment or configure OIDC for an organization, then manage membership and service accounts by workspace.
Review authenticationParticipate
Read the work, discuss it, or propose a change.
The repository and community channels are the current public places to follow and participate in Faros development.
Source
Explore the repository
Read the implementation, charts, provider code, and repository documentation from the Faros GitHub project.
Open GitHubIssues
Report or discuss a concrete problem
Use the public issue tracker for bugs and focused project changes after checking the current repository state.
Browse issuesCommunity
Join the Discord community
Use the community server for discussion with people following and working on Faros.
Open DiscordOwn the path
Start from source or start from a running hub.
The repository is the source of truth for the project. The quickstart is the shortest documented path through login, edge connectivity, and live platform use.