| .cargo | ||
| .github/workflows | ||
| apigateway | ||
| baremetal | ||
| bin | ||
| chainfire | ||
| client-common | ||
| coronafs | ||
| crates | ||
| creditservice | ||
| deployer | ||
| docs | ||
| fiberlb | ||
| flaredb | ||
| flashdns | ||
| iam | ||
| k8shost | ||
| lightningstor | ||
| mtls-agent | ||
| nightlight | ||
| nix | ||
| nix-nos | ||
| plans | ||
| plasmavmc | ||
| prismnet | ||
| scripts | ||
| .gitignore | ||
| CONTRIBUTING.md | ||
| flake.lock | ||
| flake.nix | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
| SECURITY.md | ||
| shell.nix | ||
PhotonCloud
PhotonCloud is a Nix-first cloud platform workspace that assembles a small control plane, network services, VM hosting, shared storage, object storage, and gateway services into one reproducible repository.
The canonical local proof path is the six-node VM cluster under nix/test-cluster. It builds all guest images on the host, boots them as hardware-like QEMU nodes, and validates real multi-node behavior.
Components
chainfire: replicated coordination storeflaredb: replicated KV and metadata storeiam: identity, token issuance, and authorizationprismnet: tenant networking control planeflashdns: authoritative DNS servicefiberlb: load balancer control plane and dataplaneplasmavmc: VM control plane and worker agentscoronafs: shared filesystem for mutable VM volumeslightningstor: object storage and VM image backingk8shost: Kubernetes-style hosting control planeapigateway: external API and proxy surfacenightlight: metrics ingestion and query servicecreditservice: minimal reference quota/credit servicedeployer: bootstrap and phone-home deployment servicefleet-scheduler: non-Kubernetes service scheduler for bare-metal cluster services
Quick Start
nix develop
nix run ./nix/test-cluster#cluster -- fresh-smoke
Main Entrypoints
- workspace flake: flake.nix
- VM validation harness: nix/test-cluster/README.md
- shared volume notes: coronafs/README.md
- minimal quota-service rationale: creditservice/README.md
- archived manual VM launch scripts: baremetal/vm-cluster/README.md
Repository Guide
- docs/README.md: documentation entrypoint
- docs/testing.md: validation path summary
- docs/component-matrix.md: supported multi-component compositions
- docs/storage-benchmarks.md: latest CoronaFS and LightningStor lab numbers
plans/: design notes and exploration documents
Scope
PhotonCloud is centered on reproducible infrastructure behavior rather than polished end-user product surfaces. Some services, such as creditservice, are intentionally minimal reference implementations that prove integration points rather than full products.
Host-level NixOS rollout validation is also expected to stay reproducible: the deployer-vm-smoke VM test now proves that nix-agent can activate a prebuilt target system closure directly, without recompiling the stack inside the guest.