dns-proxy-box.git · AGENTS.md

revision 55fa95d08483b5b5b3535faa710af0e9655dce8d · complete file
# Codex Agent: FountainAI Kong Configuration

This repository contains the configuration and orchestration files for running Kong and FountainAI services on a single moderate Hetzner VM.

## Responsibilities

- Maintain `configuration.yaml` for Kong and validate changes before deployment.
- Manage `docker-compose.yml` that launches the FountainAI containers behind Kong.
- Provide example environment settings in `.env.example`; keep secrets out of git.
- Include helper scripts under `scripts/` for bootstrapping and upgrades.
- Run `pytest` for any added Python modules or scripts.

## Operational Guidelines

- Use the `hcloud` CLI for provisioning the VM.
- Kong listens on ports `80` and `443` with automatic certificate issuance.
- FountainAI containers run only through Docker Compose and are reverse proxied by Kong.
- `docker compose down` should precede major updates or configuration resets.

## Codex Role

```toml
[agent]
role = "infrastructure"
type = "codex-agent"
language = "python"
```

Codex may modify any Kong, Docker or FountainAI configuration files and update the documentation under `Docs/`.