https://github.com/pixel365/zoner
Experimental EPP server for managing domain zones.
https://github.com/pixel365/zoner
Last synced: 5 months ago
JSON representation
Experimental EPP server for managing domain zones.
- Host: GitHub
- URL: https://github.com/pixel365/zoner
- Owner: pixel365
- License: mit
- Created: 2026-02-01T08:33:13.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-03-03T11:11:54.000Z (5 months ago)
- Last Synced: 2026-03-03T12:14:26.391Z (5 months ago)
- Language: Go
- Homepage:
- Size: 195 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# zoner
Experimental EPP server for managing domain zones.
## Status
This project is in **early, slow-paced development**.
APIs, behavior, and internal architecture may change at any time.
## Environment Variables
`cmd/epp` loads `.env` automatically on startup via `godotenv` (if file exists).
Use [.env.example](./.env.example) as a template for local setup.
### Runtime (`cmd/epp`)
| Variable | Required | Default | Used by | Description |
|-------------------------------|---------------|----------------------|------------------------------|-------------------------------------------------------------------------------------------|
| `CONFIG_PATH` | Yes | - | config loader | Path to YAML config file. Service panics at startup if empty or unreadable. |
| `HEALTH_LISTEN_ADDR` | No | `:8081` | health server | HTTP listen address for `/livez`, `/readyz`, `/healthz`. |
| `METRICS_ENABLED` | No | `false` | metrics collector | Enables OpenTelemetry metrics when `true`. If not `true`, noop metrics collector is used. |
| `OTEL_EXPORTER_OTLP_ENDPOINT` | Conditionally | - | OTEL metrics | OTLP gRPC endpoint for metric export (required when `METRICS_ENABLED=true`). |
| `OTEL_EXPORTER_OTLP_INSECURE` | No | `false` | OTEL metrics | Use insecure OTLP transport (`true`) instead of TLS. |
| `SERVICE_VERSION` | No | `0.0.1` | OTEL metrics resource | Value for `service.version` in OTEL resource attributes. |
| `SERVICE_NAME` | No | `unknown` | logger config | Fallback service name for logs if not set via logger options. |
| `CI_BUILD_TAG` | No | `0.0.1` | logger config | Fallback log `service.version`. |
| `TARGET_SYSTEM` | No | `dev` | logger config | Fallback log `service.environment`. |
| `POD_NAME` | No | `dev` | logger config | Fallback log `service.instance.id`. |
| `HOSTNAME` | No | OS hostname / `GOOS` | logger helpers | Hostname override used in logger host metadata. |
| `POSTGRES_DB` | Yes | - | postgres config | Database name for PostgreSQL DSN. |
| `POSTGRES_USER` | Yes | - | postgres config | Username for PostgreSQL DSN. |
| `POSTGRES_PASSWORD` | Yes | - | postgres config | Password for PostgreSQL DSN. |
| `POSTGRES_HOST` | Yes | - | postgres config | PostgreSQL host for connections (e.g. `postgres` in docker network). |
| `POSTGRES_PORT` | Yes | - | postgres config, dev compose | PostgreSQL port for app DSN and local `docker-compose.dev.yaml` port mapping. |
| `POSTGRES_SSL_MODE` | Yes | - | postgres config | `sslmode` value in PostgreSQL DSN (`disable`, `require`, etc.). |
| `POSTGRES_DATA_PATH` | No | `./data/postgres` | dev compose | Local host path used by `docker-compose.dev.yaml` volume for postgres data. |
| `REDIS_HOST` | Yes | - | redis config | Redis host. |
| `REDIS_PORT` | Yes | - | redis config | Redis port. |
| `REDIS_PASSWORD` | Yes | - | redis config | Redis password. |
| `REDIS_USERNAME` | No | empty | redis config | Redis ACL username (optional, if ACL user is configured). |
### Build/Test
| Variable | Type | Required | Used by | Description |
|---------------------------|------------------|-------------------------|-----------------------------------------|-------------------------------------------------------------|
| `SERVICE_NAME` | Docker build arg | Yes (tests image build) | `testing.dockerfile`, integration tests | Chooses which `./cmd/` binary to build in test image. |
| `POSTGRES_MIGRATIONS_DIR` | Runtime env | Yes (`cmd/migrate`) | `cmd/migrate` | Filesystem path to SQL migrations directory. |