# roji

> A simple reverse proxy for local development. Auto-discovers Docker services, provides HTTPS via *.dev.localhost.

- [Documentation](https://roji-proxy.dev/docs/): roji documentation — installation, configuration, and reference.

## Documentation

> roji documentation — installation, configuration, and reference.

- [Getting Started](https://roji-proxy.dev/docs/getting-started/): Install roji and create your first project.
- [Guides](https://roji-proxy.dev/docs/guides/): Learn how to use roji features.
- [Reference](https://roji-proxy.dev/docs/reference/): Complete reference documentation for roji.
- [Troubleshooting](https://roji-proxy.dev/docs/troubleshooting/): Solve common problems with roji.
- [Architecture](https://roji-proxy.dev/docs/architecture/): How roji works internally.

### Getting Started

> Install roji and create your first project.

- [Installation](https://roji-proxy.dev/docs/getting-started/installation/): Install roji on macOS, Linux, or WSL.
- [Quick Start](https://roji-proxy.dev/docs/getting-started/quick-start/): Get your first service running in 5 minutes.
- [Your First Service](https://roji-proxy.dev/docs/getting-started/first-service/): Build a multi-service project from scratch with roji.

### Guides

> Learn how to use roji features.

- [Configuration](https://roji-proxy.dev/docs/guides/configuration/): Configure roji via config file, environment variables, or CLI flags.
- [Static File Hosting](https://roji-proxy.dev/docs/guides/static-sites/): Serve static files without Docker containers.
- [Basic Authentication](https://roji-proxy.dev/docs/guides/basic-auth/): Protect routes with username and password.
- [Mock Routes](https://roji-proxy.dev/docs/guides/mock-routes/): Define mock API responses for frontend development.
- [Multiple Networks](https://roji-proxy.dev/docs/guides/multi-network/): Monitor multiple Docker networks simultaneously.
- [Docker Compose Patterns](https://roji-proxy.dev/docs/guides/docker-compose-patterns/): Common Docker Compose configurations with roji.

### Reference

> Complete reference documentation for roji.

- [CLI Reference](https://roji-proxy.dev/docs/reference/cli/): All roji commands and flags.
- [Docker Labels](https://roji-proxy.dev/docs/reference/labels/): All roji Docker labels for container configuration.
- [Environment Variables](https://roji-proxy.dev/docs/reference/environment-variables/): All ROJI_* environment variables.
- [Config File](https://roji-proxy.dev/docs/reference/config-file/): Complete reference for config.yaml.
- [API Reference](https://roji-proxy.dev/docs/reference/api/): Dashboard API endpoints.

### Troubleshooting

> Solve common problems with roji.

- [Common Issues](https://roji-proxy.dev/docs/troubleshooting/common-issues/): Frequently encountered problems and solutions.
- [WSL](https://roji-proxy.dev/docs/troubleshooting/wsl/): WSL-specific troubleshooting.
- [macOS](https://roji-proxy.dev/docs/troubleshooting/macos/): macOS-specific troubleshooting.
- [Linux](https://roji-proxy.dev/docs/troubleshooting/linux/): Linux-specific troubleshooting.