TikFetch Infrastructure

Docker and nginx deployment files for TikFetch.

---

Services

• tikfetch: Spring Boot application container.
• mysql: MySQL database for TikFetch.
• nginx: reverse proxy, media cache, and maintenance page.

---

First Setup

cp .env.example .env
curl -L https://raw.githubusercontent.com/TikFetch/TikFetch/main/.env.docker.example -o app.env
nano .env
nano app.env
docker compose up -d

The app image and nginx/domain settings are controlled by .env. Spring Boot settings and secrets are controlled by app.env, which is based on TikFetch/.env.docker.example.

---

Maintenance Mode

./scripts/maintenance-on.sh
./scripts/maintenance-off.sh

When maintenance is on, nginx serves the maintenance page at the same public URL and returns HTTP 503.

---

Deploy

./scripts/deploy.sh

The deploy script pulls the TikFetch image, rebuilds nginx, starts the stack, and prints container status.

---

Important

Secrets must stay in .env and app.env. Do not commit real passwords, JWT secrets, database credentials, Cloudflare tokens, or production-only values.