# server — mrj-prod-debian-13

a hand-kept record of the machine and the apps it serves. secrets live in per-app `.env` files and are never listed here.

- **hostname** — mrj-prod-debian-13
- **os** — Debian 13 (trixie), kernel 6.12
- **provider** — DigitalOcean droplet
- **public ip** — 134.209.233.24 (static)
- **ssh** — port 22
- **mail** — exim4, local-only on 127.0.0.1:25
- **edge** — Caddy 2.6.2 only — no nginx, no Traefik
- **tls** — Let's Encrypt at the origin; Cloudflare in front where proxied (Full/Full-Strict)
- **runtime** — systemd units only — no Docker, no containers
- **data** — SQLite per project — no Postgres, no MySQL, no Redis
- **notes updated** — 2026-11-17

## apps

### nexus — minimal microblog — dusty.space

- **status** — live
- **facing name** — blog (manifest source id: nubi)
- **domain** — nubi.tr
- **dns** — A -> 134.209.233.24 (direct; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/nexus.caddyfile — reverse_proxy + basicauth
- **git** — https://codeberg.org/bluegray/nexus.git
- **unit** — nexus.service
- **port** — 127.0.0.1:6601
- **stack** — Python Flask + SQLite, gunicorn
- **data** — /var/www/nexus/dusty.db
- **health** — https://nubi.tr/
- Serves a JSON Feed 1.1 manifest at /index.json; this index reads it over loopback (127.0.0.1:6601), bypassing the Caddy gate.
- Static assets must stay www-data-owned; root-owned 600 files produce 500s under gunicorn.

### bin — BIN (bank identification number) lookup

- **status** — live
- **domain** — bin.meirj.net
- **dns** — Cloudflare proxied (IPv6)
- **caddy** — /var/www/caddy/sites/bin.caddyfile — reverse_proxy
- **git** — https://codeberg.org/bluegray/bin.git
- **unit** — binlist.service
- **port** — 127.0.0.1:8091
- **stack** — Python Flask + SQLite, gunicorn
- **data** — /var/www/bin/mastercard.db (~17MB)
- **health** — https://bin.meirj.net/
- The service name differs from the directory: binlist.service runs the gunicorn module bin_web:app.
- Behind Cloudflare; keep TLS mode at Full/Full-Strict.

### evening-mirror — file uploads to Backblaze B2, SQLite metadata, temporary download links

- **status** — live
- **domain** — veriyolu.tr
- **dns** — A -> 134.209.233.24 (direct; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/evening-mirror.caddyfile — reverse_proxy
- **git** — https://codeberg.org/bluegray/evening-mirror.git
- **unit** — evening-mirror.service
- **port** — 127.0.0.1:6654
- **stack** — Python Flask + SQLite, gunicorn (2 workers)
- **data** — instance/evening_mirror.sqlite3, instance/thumbnails, instance/tmp
- **health** — https://veriyolu.tr/
- Unit differs from the others: Type=notify, module app.wsgi:app, venv at .venv, with PrivateTmp/ProtectSystem/ProtectHome hardening.
- B2 credentials live in .env and are not shown here.

### locus — book & film watchlist / reading log

- **status** — live
- **domain** — locus.meirj.net
- **dns** — A -> 134.209.233.24 (direct; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/locus.caddyfile — reverse_proxy
- **git** — https://codeberg.org/bluegray/locus.git
- **unit** — locus.service
- **port** — 127.0.0.1:5959
- **stack** — Python Flask + SQLite, gunicorn
- **data** — /var/www/locus/locus.db
- **health** — https://locus.meirj.net/

### nook — private single-user library manager (books, genres, microlibraries)

- **status** — live
- **domain** — nook.meirj.net
- **dns** — A -> 134.209.233.24 (direct; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/nook.caddyfile — reverse_proxy
- **git** — https://codeberg.org/bluegray/nook.git
- **unit** — nook.service
- **port** — 127.0.0.1:8099
- **stack** — Python Flask + SQLite, gunicorn
- **data** — /var/www/nook/nook.db
- **health** — https://nook.meirj.net/

### oihalo — minimal microblog — dusty.space

- **status** — live
- **domain** — dusty-space.meirj.net
- **dns** — A -> 134.209.233.24 (direct; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/oihalo.caddyfile — reverse_proxy
- **git** — https://codeberg.org/bluegray/oihalo.git
- **unit** — oihalo.service
- **port** — 127.0.0.1:5015
- **stack** — Python Flask + SQLite, gunicorn
- **data** — /var/www/oihalo/dusty.db
- **health** — https://dusty-space.meirj.net/
- The repo includes backup.py, a database backup helper.

### reflex — private notes app (jotter), auth-gated

- **status** — live
- **domain** — node.nit.net.tr
- **dns** — A -> 134.209.233.24 (direct; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/reflex.caddyfile — reverse_proxy
- **git** — https://codeberg.org/bluegray/reflex.git
- **unit** — reflex.service
- **port** — 127.0.0.1:8000
- **stack** — Python Flask + SQLite, gunicorn
- **data** — /var/www/reflex/data/nodes.db; goaccess reports in goaccess/
- **health** — https://node.nit.net.tr/
- The root path redirects to the login page.
- The unit adds /var/www/reflex/venv/bin to PATH.

### mrj-index — this index — timeline, search, tags, API, combined feed

- **status** — live
- **domain** — index.meirj.net
- **dns** — A -> 134.209.233.24 (direct; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/index.caddyfile — reverse_proxy + basicauth
- **git** — https://codeberg.org/bluegray/mrj-index.git
- **unit** — mrj-index.service + mrj-index-sync.timer
- **port** — 127.0.0.1:8010
- **stack** — Python Flask (app factory) + pydantic v2 + requests + SQLite (WAL, FTS5), gunicorn (2 workers)
- **data** — instance/index.sqlite3 — rebuildable from manifests
- **health** — https://index.meirj.net/sources
- Sync runs every 15 minutes under flock, so runs never overlap; log at /var/log/mrj-index/sync.log.
- Run manual sync commands with cd /var/www/mrj-index, or --app app imports the wrong module.
- The whole site sits behind Caddy basicauth; this /server page is part of it.
- The same record is served as Markdown at /server.md (text/markdown, inline), generated from server.toml by render_markdown so it cannot show anything this page hides.
- /plan serves the server migration plan as text/markdown from /var/www/PLAN.md (PLAN_FILE config), read per request; edits need no restart, the route itself did.

### lekkima — small server-rendered journal / diary — entries, tags, backlinks

- **status** — live
- **domain** — lekkima.meirj.net
- **dns** — A -> 134.209.233.24 (direct, DNS-only; Cloudflare planned)
- **caddy** — /var/www/caddy/sites/lekkima.caddyfile — reverse_proxy, no basicauth
- **git** — https://codeberg.org/bluegray/lekkima.git
- **unit** — lekkima.service
- **port** — 127.0.0.1:8101
- **stack** — Python 3.13, Flask 3.1, Markdown, SQLite, gunicorn 26 (1 worker/4 threads)
- **data** — /var/www/lekkima/lekkima.db (table tos; schema.sql)
- **health** — https://lekkima.meirj.net/
- No app-level auth and no Caddy basicauth: every write route is open to the internet (user decision, 2026-10-22).
- Single-file app.py; venv/ rather than .venv.

### twig — private media archive — stable short URLs, QR, tags + FTS, collections, public subset

- **status** — live
- **facing name** — zwig
- **domain** — zwig.nubi.tr
- **dns** — A -> 134.209.233.24 (Cloudflare DNS-only; LE HTTP-01 reaches origin)
- **caddy** — /var/www/caddy/sites/zwig.caddyfile — reverse_proxy, 100MB body limit
- **git** — https://codeberg.org/bluegray/twig.git
- **unit** — twig.service + twig-worker.service; backup/export/verify timers
- **port** — 127.0.0.1:8102
- **stack** — Python 3.13, Flask 3 + SQLAlchemy 2 + SQLite (WAL, FTS5), Pillow/PyMuPDF, Huey, gunicorn (2 workers)
- **data** — var/twig.db, var/media (content-addressed originals + derived), var/huey.db
- **health** — https://zwig.nubi.tr/health — JSON ok; 503 if DB or media is unhealthy
- Single owner; private by default, anonymous visitors see only public posts.
- B2 sync is prepared but not enabled: rclone is not installed and no B2 remote exists.
- Source root is root-owned and read-only for www-data.

### reader — static reading engine / bookmarklet

- **status** — live
- **domain** — reader.meirj.net
- **dns** — Cloudflare proxied
- **caddy** — /var/www/caddy/sites/reader.caddyfile — root /var/www/reader + file_server
- **port** — none (static)
- **stack** — plain HTML/CSS/JS, no build step
- **data** — /var/www/reader
- **health** — https://reader.meirj.net/

### static — static-file drop zone — drop a folder, it is served

- **status** — live
- **domain** — static.meirj.net
- **dns** — A -> 134.209.233.24 (Cloudflare DNS-only, so LE HTTP-01 reaches origin)
- **caddy** — /var/www/caddy/sites/static.caddyfile — root /var/www/static + file_server browse
- **port** — none (static)
- **stack** — Caddy file_server only
- **data** — /var/www/static (root:www-data, 2775 setgid)
- **health** — https://static.meirj.net/
- New subfolders go live with no restart; only a new hostname needs a config file plus a Caddy restart.
- Never put secrets in the drop zone. Dotfiles/dot-dirs are 404'd by a route matcher.
- /hw-report.sh (2026-11-20) is a public helper: prints hardware/OS facts and PUTs them to curl.meirj.net. No secrets collected; safe to pipe to sh.

### curldrop — curl-first file drop with a talking layer (plain-text/JSON listing of its files)

- **status** — live
- **domain** — curl.meirj.net
- **dns** — A -> 134.209.233.24 (Cloudflare DNS-only, not proxied)
- **caddy** — /var/www/caddy/sites/curl.caddyfile — reverse_proxy, 512MB body limit, no basicauth
- **git** — https://codeberg.org/bluegray/curly-drop.git
- **unit** — curldrop.service
- **port** — 127.0.0.1:8103
- **stack** — Python 3.13, Flask 3.1, gunicorn 26; no database
- **data** — /var/www/curl/files (uploads) + files/.meta/*.json sidecars (note, content-type)
- **health** — https://curl.meirj.net/health — 200 with ok:true
- Upload with: curl -T ./file https://curl.meirj.net/ (or /u/<name>, or -F file=@... repeatable).
- GET / is the talking layer: plain text by default, JSON with ?format=json or Accept: application/json. Also GET /info/<name>, GET /f/<name>, DELETE /f/<name>.
- Writes are open to the internet by default; set CURL_TOKEN in /var/www/curl/.env and restart curldrop to require a bearer token on PUT/POST/DELETE (reads stay public).
- GET /readme (text/markdown) and /llms.txt (text/plain) serve /var/www/curl/README.md live, so agents can self-document.
- Filenames are reduced to a sanitized basename, dotfiles are rejected and traversal returns 400; uploads are streamed to a temp file then atomically renamed (max 500MB app / 512MB edge).
- The repository was created on 2026-11-17 and named curly-drop, not curl; uploads (files/), the venv and .env are ignored, so the box still owns the live data.

## operational notes

### edge & tls

Caddy is the only reverse proxy. Reload fails by design (admin off, SIGHUP unsupported), so apply config changes with systemctl restart caddy. Always run caddy validate --adapter caddyfile --config /etc/caddy/Caddyfile first: one bad site file takes every site down. This box runs Caddy 2.6.2, which spells it basicauth, not basic_auth.

### domains & cloudflare

Only bin.meirj.net is Cloudflare-proxied today; every other domain points directly at 134.209.233.24. The plan is to move all apps behind Cloudflare, setting TLS mode to Full/Full-Strict so the origin Let's Encrypt certs keep working.

### deploy

Apps live in /var/www/<appname> and deploy by git push to codeberg.org/bluegray/<appname>, then systemctl restart <unit> (exact automation still to be settled). One exception: curldrop lives at codeberg.org/bluegray/curly-drop. Per-domain Caddy configs live in /var/www/caddy/sites.

### data & backups

Each project keeps its own SQLite file. WAL mode and file permissions matter; per-project backups are still a to-do. mrj-index itself is rebuildable from the site manifests, at the cost of first-seen timestamps and move history.

### dns cache gotcha

After adding a DNS record, systemd-resolved on 127.0.0.53 may keep an NXDOMAIN and make ACME fail. Run resolvectl flush-caches and confirm with resolvectl query <host> before restarting Caddy.

### security posture

Public ports are meant to be 22, 80, 443 only; app ports are bound to 127.0.0.1. ufw is not currently installed, so treat the localhost bindings as the real boundary. Secrets live in per-app .env files and are deliberately absent from this page.
