FRKN

Development env with static website for frkn.org, served by Nginx. Suitable for web dev iterations.

Run locally with Docker

Requirements

• Docker/Podman/OrbStack

Build and start

From the repository root:

docker build -t frkn-org .
docker run --rm -p 8080:80 frkn-org

Open the site at:

http://localhost:8080

• The container serves port 80; -p 8080:80 maps it to port 8080 on the host.

• Stop the server with Ctrl+C. The --rm flag removes the container automatically.

• Verify the container

The image exposes a health endpoint:

curl http://localhost:8080/health

Expected response:

ok

Run the subscription wizard without a backend

/subscription/?id=… normally talks to api.frkn.org. To click through the wizard (including the AmneziaWG "download all configs as .zip" button) fully locally, run the mock API and open the page with &mock=1:

# terminal 1 — mock api.frkn.org (http://127.0.0.1:3000)
node tools/mock-api/serve.js

# terminal 2 — the site
docker build -t frkn-org .
docker run -d --rm -p 8081:80 --name frkn-preview frkn-org

Then open:

http://localhost:8081/subscription/?id=demo-uuid-0000&mock=1

Click «Больше настроек и приложений» → AmneziaWG → pick an OS → the final step shows «⬇ Скачать все (N конф., .zip)» (raw), «⬇ AmneziaWG 3.x (N конф., .zip)» (3.1 client) and «⬇ AmneziaWG 2.x (M из N конф., .zip)» (AWG 2.0 field set for the Google Play build).

Docs

• docs/RUNBOOK.md — build/run/health, mock API, e2e test, screenshots, deploy.
• docs/ARCHITECTURE.md — how the static site fits together.