https://github.com/holos-run/holos-console
Holos Web UI and gRPC API server
https://github.com/holos-run/holos-console
connectrpc go grpc holos oidc pkce react typescript
Last synced: about 1 month ago
JSON representation
Holos Web UI and gRPC API server
- Host: GitHub
- URL: https://github.com/holos-run/holos-console
- Owner: holos-run
- License: apache-2.0
- Created: 2026-01-03T05:03:05.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-01-27T15:35:11.000Z (2 months ago)
- Last Synced: 2026-01-27T15:42:59.558Z (2 months ago)
- Topics: connectrpc, go, grpc, holos, oidc, pkce, react, typescript
- Language: Go
- Homepage: https://holos.run
- Size: 664 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Holos Console
A Go HTTPS server that serves a web console UI for managing Kubernetes secrets with OIDC authentication and role-based access control. The built UI is embedded into the Go binary for single-binary deployment.
## Quick Start
```bash
make certs # Generate TLS certificates (one-time)
make run # Build and start the server
```
Open in your browser. `make run` enables the embedded Dex OIDC provider (`--enable-insecure-dex`) which auto-logs in for local development.
## Reference Documentation
| Document | Description |
|----------|-------------|
| [CONTRIBUTING.md](CONTRIBUTING.md) | Development setup, build commands, testing, and commit message format |
| [AGENTS.md](AGENTS.md) | Agent and CI guidance for working with this codebase |
| [docs/authentication.md](docs/authentication.md) | OIDC PKCE authentication with embedded Dex or external provider |
| [docs/rbac.md](docs/rbac.md) | Project-level grants, per-secret sharing grants, and permission model |
| [docs/secrets.md](docs/secrets.md) | Secret data model, UI workflows, and consuming secrets in pods |
| [docs/dev-server.md](docs/dev-server.md) | Two-server development setup (Go backend + Vite dev server) |
| [docs/hostname-configuration.md](docs/hostname-configuration.md) | Hostname and port configuration, reverse proxy setup |
| [docs/observability.md](docs/observability.md) | Structured logging, audit events, and Datadog integration |
| [docs/rpc-service-definitions.md](docs/rpc-service-definitions.md) | Protobuf and ConnectRPC code generation, adding new RPCs |
| [docs/adrs/](docs/adrs/) | Architecture Decision Records |
| [docs/research/](docs/research/) | Technical research and analysis documents |