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.

Article Created Updated

Reviewed by adrian on

I wanted a home on the web that was not a timeline on someone else's platform: a slow place of my own for blog posts, notes, links and photos. That place was adrian-altner.de, built with Astro. The source lived in my own Git repository at git.altner.cloud/adrian/adrian-altner.de.1

The first post

The site went live on 1 December 2025 with a short post called "Hello, World!". It explained the phrase: one of the first lines a new programming student writes, a way of saying hello in the world of coding.2

How it was built

  • Astro on the Node.js standalone adapter, TypeScript throughout.
  • Rendering: most routes were prerendered as static pages. A handful of pages used server-side rendering where they needed it.
  • Content: Astro content collections with Zod schemas, so the frontmatter was type-checked at build time. A typo in a pubDate failed the build instead of producing a broken page.
  • IndieWeb: posts were syndicated to Mastodon by my own POSSE script. Incoming webmentions came from webmention.io at build time and appeared on the post they referred to. Microformats2 markup ran through the whole site for anyone parsing the HTML.
  • Photos: JPG files with JSON sidecars, organised into nested collections with breadcrumb navigation. No database and no image CDN, only files on disk. The sidecars came from a script described in Photo Sidecars with a Vision Model.
  • Feeds: an RSS feed for every content type.1

How it ran

The site ran as a container with Podman on a Debian VPS, with Caddy in front. The guides from that time:


  1. My Website, March 2026. ↩

  2. Hello, World!, December 2025. ↩

Based on

  • My Website (raw/2026/2026-03-26/my-website.md) [site]
  • Hello, World! (raw/2025/2025-12-01/hello-world.md) [hello]

More on this

Topic

  • Static Website A website made of finished HTML files that are built once and then served unchanged. No server code, no database.

Uses

  • Astro Tool for building websites from content such as Markdown. Ships plain HTML by default and only loads JavaScript where it is needed.
  • Caddy Web server and reverse proxy that obtains and renews TLS certificates on its own, configured in a short Caddyfile.
  • Podman Container engine without a background daemon that runs rootless by default on Linux and uses the same commands on macOS and on a server.

Mentioned

Show in the graph view