mrj-index

server

the machine under all of this, and the apps it runs. read this as markdown.

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

the apps this box serves, and how each one is wired.

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
unit
nexus.service
port
127.0.0.1:6601
stack
Python Flask + SQLite, gunicorn
data
/var/www/nexus/dusty.db
  • 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
unit
binlist.service
port
127.0.0.1:8091
stack
Python Flask + SQLite, gunicorn
data
/var/www/bin/mastercard.db (~17MB)
  • 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
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
  • 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
unit
locus.service
port
127.0.0.1:5959
stack
Python Flask + SQLite, gunicorn
data
/var/www/locus/locus.db

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
unit
nook.service
port
127.0.0.1:8099
stack
Python Flask + SQLite, gunicorn
data
/var/www/nook/nook.db

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
unit
oihalo.service
port
127.0.0.1:5015
stack
Python Flask + SQLite, gunicorn
data
/var/www/oihalo/dusty.db
  • 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
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/
  • 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
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
  • 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
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)
  • 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
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
  • 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

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)
  • 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
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)
  • 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

the things worth remembering before touching this box.

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.

this page is a hand-kept copy of the notes. secrets stay in per-app .env files and are never shown here.