2026 97

November 18

  • OpenRB-338 Experiments

    My ideas for OpenRB-338 and the rb-songs and rb-mods collections: playing, a song archive, a jukebox with MilkDrop, short videos.

  • Thailand Traffic Survival Guide

    How to get through city traffic in Thailand on foot and at the wheel: real-world rules, junctions, U-turns, accidents and emergency numbers.

  • Fetching Search Console and Bing Data via API

    A read-only Google service account and a Bing API key for a weekly script on my server, set up step by step in the German interfaces, with the mistakes to avoid.

  • Registering a Website with Google and Bing

    Google Search Console via a DNS record at Cloudflare, Bing Webmaster Tools by import, then check sitemap and IndexNow.

  • Visitor Statistics from the Server Log with Matomo

    A self-hosted Matomo fed hourly from Caddy's access log: no tracking script, no cookies, masked IP addresses.

  • What the Machine Sees

    A small app from my old website: choose a photo, and the vision model Mirage found objects, text and the scene in it, entirely in the browser.

  • Measuring the Search of My Knowledge Base

    Five local embedding models against 26 test questions: why the search now runs on BGE-M3 instead of multilingual-e5-small, with a new minimum score.

  • Securing a Persistent AI Agent

    How to let an AI agent work on its own without handing it the keys: OpenAI's five safeguards explained, and how I apply them to my own agents.

  • Encrypted pCloud Backup with rclone

    Guide: a nightly, client-side encrypted backup from the Mac to pCloud with rclone and launchd, with a 90-day archive and tested restores.

  • How a Zettelkasten Works

    The Zettelkasten after its two classic descriptions: Luhmann's report on his slip box from 1981 and Ahrens' workflow for writing from 2017.

  • Price and Stock Tracker

    Streamlit app that reads a supplier's daily article list and stores only changes in price, stock and listing in DuckDB, with price index and stock movements.

  • RSS News with n8n and OpenRouter

    Guide: n8n reads security notices, a language model rates and rewrites them, and a restricted SSH script commits them to the Git repository of a static site.

  • Securing a Hosted MCP Server

    Plan for a hosted MCP server for the knowledge base that claude.ai on the web and on mobile can use, while nobody else can.

  • Hermes Agent on a VPS Behind WireGuard

    Guide: Hermes Agent in Docker on the VPS yaksha, dashboard behind Caddy and reachable only through WireGuard, container cut off from the tunnel network.

  • Safari Bookmark Sorter

    Python script that sorts Safari bookmarks into folders with Claude Haiku and hands the result to Safari as an import file, so iCloud syncs it.

  • How an LLM Wiki Works

    How an LLM wiki works, shown on this knowledge base: Markdown in its own Git repository, a Python tool with MCP for agents, and a website that only displays it.

  • Markdown as a Database

    For a personal website, a folder of Markdown files with a structured header replaces the database, as long as a schema checks it.

  • Why a Graph

    A list sorted by date shows what is new. A graph shows what belongs together. This website needs both.

July 35

June 1

April 13

  • Astro Client Islands under a Strict CSP

    Why Astro islands fail silently under script-src 'self', how I allowed the two hydration inlines by sha256 hash, and a deploy check for hash drift.

  • Astro Justified Gallery Layout

    My npm package @altner/astro-justified-gallery-layout: a small justified gallery for Astro with EXIF, LQIP previews, a virtual variant and a lightbox.

  • A Callout Component for Astro

    A reusable Astro info box with info, note and warning variants, an optional title, social links and a members section with links per person.

  • A GDPR-Compliant Google Maps Embed

    An Astro component that loads Google Maps only after consent, stores the decision in localStorage and builds Google and Apple Maps links from coordinates.

  • A GDPR-Compliant YouTube Embed

    An Astro component that loads YouTube only after a click: show once, agree and remember, or just the link. No cookie, no request to Google before consent.

  • Leaflet and Stadia Maps Behind a Strict CSP

    Two fixes that made the photo world map work in production: the tile host in img-src and a Referrer-Policy of origin on the tiles.

  • Why Stadia Maps Instead of OpenStreetMap Tiles

    For the photo world map I wanted OpenStreetMap data from an EU server without running a tile server myself. Stadia Maps met every criterion.

  • Caching Webmention Avatars Locally

    An Astro helper that downloads webmention avatars during the build, dedupes and sweeps them, so the CSP stays strict and readers never hit the avatar host.

  • Security Headers in Caddy

    A strict Content Security Policy, HSTS and no-referrer in a Caddy site block, checked with Webbkoll, securityheaders.com and the Mozilla Observatory.

  • Setting Up a Forgejo Actions Runner

    Push-to-deploy with a self-hosted Forgejo Actions runner on the same VPS: own user, no Docker, narrow sudo rights and secrets kept in Forgejo.

  • Image Voice Memos

    Native macOS app that pairs photos with voice memos and transcribes them on the device with Apple's speech recognition.

  • Forgejo on Debian 13 with Rootless Podman

    Forgejo as a rootless Podman container under its own user: a Quadlet for systemd, Caddy in front, SSH on port 2222 and the problems I ran into.

  • Initial VPS Setup on Debian

    First steps on a fresh Debian VPS: current packages, automatic security updates, a non-root user and SSH with keys only.

March 30

  • Obsidian Wiki-Links in Astro with a Remark Plugin

    A small Remark plugin that turns Obsidian [[wiki-links]] into normal links at build time, with labels, heading anchors and a fallback for unknown targets.

  • POSSE to Mastodon

    A Mastodon syndication script for articles and notes: state keyed by canonical URL, OG image uploads that fail open, backoff on 429, dry runs and batch limits.

  • Troubleshooting Mastodon Backfeed

    A runbook for Mastodon, Bridgy and webmention.io: token scopes, deploy order, trailing slashes, 429s on media uploads and reactions that are gone upstream.

  • Bluesky Reactions as Webmentions with Bridgy

    Bridgy polls Bluesky for likes, reposts and replies to syndicated posts and sends them back as webmentions, so they appear on the original post.

  • Improving Bluesky Syndication

    Notes as a second source, OG images compressed with Sharp below the blob limit, publish dates as timestamps and Bluesky URLs in a committed state file.

  • Joining the IndieWeb

    Why I made my own domain the canonical home of everything I publish, and how rel=me and h-card verified my identity on the old site.

  • Live Webmentions on a Static Site

    Webmentions rendered at build time plus a silent client-side refresh, so new likes and replies show up on a static Astro site without SSR or a redeploy.

  • Marking Up Posts with Microformats2 h-entry

    h-entry, h-card, h-feed and u-syndication classes on articles, notes and photos of an Astro site, machine-readable without any visible change.

  • Obfuscating Contact Data on a Static Site

    Base64 in a data attribute and reversed text flipped back by CSS keep the imprint's email address away from harvesters and from copy and paste.

  • POSSE to Bluesky with the AT Protocol

    A Node script at the end of every deploy that posts new articles from the RSS feed to Bluesky as rich link cards, straight through the AT Protocol API.

  • Receiving and Sending Webmentions

    Incoming webmentions through webmention.io, rendered at build time in Astro, and outgoing ones sent by webmention.app after every deploy.

  • Syndication Links from State

    Astro imports the syndication state file at build time and renders u-syndication links on every post, so the frontmatter never needs a second edit.

  • Adding Notes, Links and Archives

    Three sections of my old Astro site: short notes rendered inline, a link log as a data collection, and one archive across every content type.

  • Collection Sets and Category Collections

    One boolean in the frontmatter told the photo sets of my old site apart from pure navigation nodes, so only finished sets reached the archive.

  • Structuring Photos as a Collection Tree

    How the photos of my old Astro site grew from flat albums into a recursive tree: one catch-all route, photos per node, breadcrumbs and tag pages.

  • Syndicating Photos to Flickr

    A script that makes Flickr match the photo tree of my old site: upload, delete, move between albums, and write the Flickr ID and stats back into the sidecars.

  • Building the Photo Stream

    The photo stream of my old Astro site: JSON sidecars next to each JPG, import.meta.glob, a justified grid and batches revealed on scroll.

  • Photo Albums with Astro's Content Layer

    Album pages on top of the photo stream of my old site: a content collection per album, covers by filename, album-scoped photo routes and a sub-nav.

  • Photo Sidecars with a Vision Model

    The script vision.ts of my old site: EXIF data and a vision model's alt text, titles and tags in a JSON file next to each photo, generated locally before the deploy.

  • Obsidian to VPS Pipeline: Sync, Pull and Redeploy

    One shell script on the Mac that pulls the site repository on the VPS, rsyncs the posts from the Obsidian vault and rebuilds the Astro container.

  • Mirroring GitHub to Codeberg

    A GitHub Actions workflow that mirrors branches and tags to Codeberg with plain git push over SSH, without a third-party action.

  • Triggering VPS Deploys with GitHub Actions

    A GitHub Actions workflow that opens an SSH session to the VPS on every push to main and lets the server pull and rebuild itself.

  • GitHub Deploy Key on a VPS

    A read-only SSH deploy key so a VPS can pull from GitHub without a personal access token or a password.

  • Installing Podman Locally and on a VPS

    Podman with podman-compose on macOS and on a Debian or Ubuntu server, with the same commands on both sides and a first-run check.

  • Keeping a Compose Stack Running After a Reboot

    A systemd unit that starts a Podman compose stack on boot, so a website comes back by itself after the VPS restarts.

  • Operating Astro SSR in Production with Podman

    A short runbook for the Astro container on the VPS: start and stop, health checks, the four-command update, rollback by commit and Caddy checks.

  • Updating the Website Repository on a VPS

    A repeatable update flow on the VPS: check the working tree, pull with --ff-only, rebuild with podman-compose, verify, roll back, all in one script.

  • Caddy as Reverse Proxy with HTTPS and a Canonical Host

    Caddy in front of a container on a VPS: automatic TLS from Let's Encrypt, www redirected to the bare domain, the app port closed to the outside.

  • Deploying Astro SSR to a VPS with Podman

    Moving the Astro SSR container to a fresh Debian VPS: Podman from the distro packages, a read-only deploy key and the same compose file.

  • Astro SSR with Podman: From Local Setup to VPS

    Astro with the Node standalone adapter in a two-stage Podman container, run locally with the same compose file that later goes to the VPS.

2025 1

December 1

  • My Old Astro Website

    My old site at adrian-altner.de: Astro with the Node adapter, typed content collections, IndieWeb features and photos as files with JSON sidecars.