# Bastion

> Documentation for Bastion, version 1.x.
> Every entry links to the page's markdown source.

Repository: https://github.com/xraph/bastion
Site: https://www.xraph.com/docs/bastion

## Pages

- [Admin REST API](https://www.xraph.com/docs/bastion/api-reference/admin-api.md): Full CRUD API for routes, upstreams, stats, and configuration.
- [Admin Dashboard](https://www.xraph.com/docs/bastion/api-reference/dashboard.md): Real-time ForgeUI-based gateway dashboard.
- [Go Packages](https://www.xraph.com/docs/bastion/api-reference/go-packages.md): Package imports and API documentation reference.
- [Architecture](https://www.xraph.com/docs/bastion/architecture.md): How the request pipeline, middleware chain, and extension lifecycle work in Bastion.
- [Configuration](https://www.xraph.com/docs/bastion/concepts/configuration.md): Programmatic and YAML configuration for Bastion with hot-reload support.
- [Error Handling](https://www.xraph.com/docs/bastion/concepts/errors.md): Gateway error types, error hooks, custom error pages, and upstream failure handling.
- [Protocols](https://www.xraph.com/docs/bastion/concepts/protocols.md): HTTP, WebSocket, SSE, and gRPC proxying in Bastion.
- [Routes](https://www.xraph.com/docs/bastion/concepts/routes.md): Route configuration, path matching, protocol selection, and per-route overrides.
- [Upstreams](https://www.xraph.com/docs/bastion/concepts/upstreams.md): Upstream target configuration, health states, weights, and connection pooling.
- [Getting Started](https://www.xraph.com/docs/bastion/getting-started.md): Install Bastion and configure your first API gateway in under ten minutes.
- [Forge Extension](https://www.xraph.com/docs/bastion/guides/forge-extension.md): Integrate Bastion as a Forge extension with auto-configuration and DI container binding.
- [Full Example](https://www.xraph.com/docs/bastion/guides/full-example.md): Complete gateway setup with routes, discovery, load balancing, circuit breakers, and dashboard.
- [Hook System](https://www.xraph.com/docs/bastion/guides/hooks.md): Extend gateway behavior with OnRequest, OnResponse, OnError, and lifecycle hooks.
- [OpenAPI Aggregation](https://www.xraph.com/docs/bastion/guides/openapi-aggregation.md): Unified OpenAPI specification from all upstream services via FARP.
- [Introduction](https://www.xraph.com/docs/bastion.md): Production-grade API gateway extension for the Forge Go framework.
- [Authentication](https://www.xraph.com/docs/bastion/subsystems/authentication.md): Request authentication via API keys, Bearer tokens, and forward auth.
- [Response Caching](https://www.xraph.com/docs/bastion/subsystems/caching.md): In-memory response caching with per-route policies.
- [Circuit Breakers](https://www.xraph.com/docs/bastion/subsystems/circuit-breakers.md): Per-target failure isolation with three-state circuit breakers.
- [Service Discovery](https://www.xraph.com/docs/bastion/subsystems/discovery.md): FARP-based automatic service discovery and route generation.
- [Health Monitoring](https://www.xraph.com/docs/bastion/subsystems/health-monitoring.md): Active and passive health checking for upstream targets.
- [Load Balancing](https://www.xraph.com/docs/bastion/subsystems/load-balancing.md): Traffic distribution strategies across upstream targets.
- [Observability](https://www.xraph.com/docs/bastion/subsystems/observability.md): Prometheus metrics, structured access logging, and OpenTelemetry trace propagation.
- [Proxying](https://www.xraph.com/docs/bastion/subsystems/proxying.md): Multi-protocol reverse proxy engine.
- [Rate Limiting](https://www.xraph.com/docs/bastion/subsystems/rate-limiting.md): Token-bucket rate limiting at global, per-route, and per-client levels.
- [TLS & mTLS](https://www.xraph.com/docs/bastion/subsystems/tls.md): Upstream TLS with CA certificates, client certs for mTLS, and auto cert reloading.
- [Traffic Splitting](https://www.xraph.com/docs/bastion/subsystems/traffic-splitting.md): Canary releases, blue-green deployments, A/B testing, and shadow traffic.
- [Request Transformation](https://www.xraph.com/docs/bastion/subsystems/transformation.md): Path rewriting, header manipulation, and prefix stripping.