shotgun.dev

Notes from building and running small software systems.

Backend work, Linux boxes, DNS, services, debugging, and the parts of projects that are easier to understand after writing them down.

Notes

  1. Site setup Static HTML on nginx. Nothing fancy yet.
  2. DNS without breaking mail A checklist before touching records again.
  3. Small services When a script needs config, logs, restarts, and a name.

Site setup

This page is intentionally plain. It is a place to collect engineering notes before adding a generator, feed, archive, or any other machinery that has to justify itself.

The current version is static files served by nginx. That makes it easy to back up, easy to move, and difficult to overcomplicate by accident.

DNS without breaking mail

Before changing web records, keep a copy of the zone and check the mail records separately. The easy mistake is treating the domain like it only serves a website.

Good notes here should include the original records, the intended change, the command that made it, and the resolver check after the fact.

Small services

A small service usually starts as a script. Then it needs an environment file, logs, a restart policy, a health check, and some record of where it lives.

The trick is adding just enough ceremony that it survives reboot and memory, without turning every helper into a platform.

Topics