Journal
New entries and changes to old ones, newest first.
2026-11-13Friday
- newConfigLinux · Ubuntu servercloud-init: a server configured the moment it’s createdPaste a cloud-config user-data file into the provider’s panel when you create the server, and on first boot it does what the set’s manuals do: a user with a key, key-only login, updates with reboots, swap, a firewall. You log in as
example-userfrom the start.cloud-init 24.x–25.x (Ubuntu 24.04 and 26.04) - changeConfigLinux · Ubuntu servercloud-init: a server configured the moment it’s createdThe
sshdand auto-update files inwrite_filesnow match sshd_config and unattended-upgrades in full: closing abandoned sessions withClientAlive*, rebooting with a session open and finishing an interrupted install are added.cloud-init 24.x–25.x (Ubuntu 24.04 and 26.04) - changeOverviewDevelopment · PythonNumbers in Python: integers without a limit, fractions with an errorHow to load a module:
importandfrom … import.Python 3.15.1 (Windows) — examples, output and error messages run - changeManualDevelopment · PythonA 120-bit password from your own script: the first .py file and the secrets module
importis now introduced in the Numbers chapter, where it first appears.Python 3.15.1 (Windows) — script and output run - changeConfigDesign · TypographyYour own font on a site: @font-face, subsets and loading without a jumpOn Russian pages the site now preloads the Latin Golos file too: until it arrives, the fallback font draws the spaces and digits.Astro 7.4, `fonts` in `astro.config.mjs` — CSS and files from this site’s build · the Google Fonts CSS API response (`fonts.googleapis.com/css2`) · `size-adjust` and `*-override` support — per MDN data
2026-11-12Thursday
- changeRecipeHomelab · Server changesMoving to a new server
web2also gets its own restore check,web2-verify, in Healthchecks.io: the level 5 check now pings a separate URL.Ubuntu 24.04 · Kopia 0.23 · git 2.43 · GitHub: private repositories, deploy keys - changeRecipeHomelab · BackupsA backup that outlives the serverThe restore check looks at the data:
integrity_checklet a dump of an empty database through. The check pings its ownweb1-verifyin Healthchecks.io, so a disabled or crashed check shows up now.Ubuntu 24.04 · Kopia 0.23 · rclone 1.60 - changeRecipeHomelab · BackupsA backup that outlives the serverStorage a hacked server can’t wipe — a link to the Kopia server manual.Ubuntu 24.04 · Kopia 0.23 · rclone 1.60
2026-10-31Saturday
- changeOverviewDocker · Docker EngineDocker: what it is, where it came from and what it costs“Where to start” — Docker networks and your own image.Docker Engine 29, Compose v5 — Ubuntu 24.04 · history — Docker and Linux kernel release notes
- newManualDocker · Images and DockerfileYour own image: a multi-stage build of a static siteBuild the site in one Dockerfile stage and put only the result into the image: nginx and the finished pages, without Node,
node_modulesor sources. Line order decides how long a rebuild takes: copy the dependencies before the code, and a text edit won’t rerunnpm ci.Docker Engine 29 with BuildKit · node:24.22.1-alpine, nginx:1.31.8-alpine · Astro 7 — a working Dockerfile for a static site - newTipDocker · Images and Dockerfile.dockerignore — before the first COPY . .
COPY . .copies everything from the build directory into the image except what’s listed in.dockerignore:.envwith passwords,.gitwith its whole history,node_modulesbuilt for the laptop’s OS. Put the file next to theDockerfilebefore the first build, not after the first leak.Docker Engine 29 with BuildKit · Node 24, esbuild - newTipDocker · Images and DockerfileA build token goes through --secret, not ARG
ARGandENVare no good for secrets: the value stays in the image, and everyone who pulled the image can see it. Pass a token needed only during the build — for a private npm registry or a private repository — withdocker build --secret: it shows up in oneRUNand doesn’t stay in the layers.Docker Engine 29 with BuildKit · Node 24, npm 11 - newManualDocker · Docker networksDocker networks: neighbors by name, a shared network with Traefik and a database with no way outContainers find each other by name only within their own network: the default
bridgenetwork has no names. A service behind a proxy needs two networks — a sharedproxynetwork that Traefik uses to reach it, and an internal one withinternal: true, where the database is visible to its neighbors but can’t reach the outside itself.Docker Engine 29, Compose v5.6 — Ubuntu 24.04 · Traefik 3.7 · stack configs with Traefik and a database on production servers - newTipDocker · Docker networksA service’s networks list replaces the default networkAs soon as a service has a
networks:list, compose connects it only to the listed networks, and the service leaves the stack’sdefaultnetwork. Add theproxynetwork for Traefik, and the service stops seeing the database that stayed ondefault. List every network the service should be on.Docker Compose v5.6 - newTipDocker · Docker networksDocker’s subnet clashed with the home network — set default-address-poolsDocker takes subnets for user-defined networks in order: fifteen
/16s from172.17–172.31, then/20chunks of192.168.0.0/16, where home and office networks usually live. Once a subnet matches the network the server is reached from, replies to those machines go into the Docker bridge. Set the pool yourself indaemon.jsonwhile there are still few networks.Docker Engine 29 — Ubuntu 24.04 · default pools — Moby source code, `ipamutils` - newOverviewHomelab · ProxmoxWhere Proxmox came from: virtualization before it and the road from 0.9 to 9.2Virtual machines appeared on IBM mainframes in the 1960s, VMware brought them to x86 in 1999, and in 2007 the Linux kernel itself became a hypervisor — KVM. In 2008 Proxmox VE put KVM and OpenVZ containers on Debian under one web UI. Since then it has swapped OpenVZ for LXC and gained ZFS, Ceph, clustering and its own backups. People started moving from VMware to Proxmox en masse when Broadcom killed the free ESXi in 2024.Proxmox VE Roadmap — release dates from 1.0 to 9.2, as of 2026-10-31 · Proxmox VE FAQ — branch support periods
- newOverviewHomelab · ProxmoxHardware for Proxmox: CPU, memory, disks and network cardsProxmox VE installs on almost any 64-bit computer with VT-x or AMD-V, even a decade-old PC. The limits are elsewhere: memory shared by the guests and the ZFS cache, and SSDs — consumer drives without power-loss protection are slow at synchronous writes and wear out faster under ZFS. Intel I219 and some Realtek network cards need one line of configuration.Proxmox VE 9.2, kernel 7.0.14, on a dual-core PC with 16 GB of memory · requirements — the Proxmox VE System Requirements page as of 2026-10-31
- newOverviewHomelab · ProxmoxVirtual machine or LXC container in Proxmox: which service goes whereA VM is a separate computer with its own kernel: any OS, full isolation, moving to another node without stopping. An LXC container is Linux on the host’s kernel: it starts in a second and eats tens of megabytes, but shares the kernel and its vulnerabilities with the host. A service from Linux packages goes into a container; Docker, untrusted code and any other OS go into a VM.Proxmox VE 9.2: QEMU 11.0.3, LXC 7.0, `pve-container` 6.1.14 · recommendations — the Proxmox Container Toolkit chapter and the Proxmox VE FAQ
- newOverviewHomelab · ProxmoxProxmox storage: local, local-lvm, ZFS — what lives where and what it can doA storage in Proxmox is where guest disks, ISOs, templates and backups go. After an ext4 install there are two:
local— the/var/lib/vzdirectory for files — andlocal-lvm— an LVM thin pool for guest disks. What a storage can do — snapshots, thin disks, shared access from a cluster — is decided by its type, not by the disk underneath.Proxmox VE 9.2: `libpve-storage-perl` 9.1.13, ZFS 2.4.4 · storage types — the Proxmox VE Storage chapter as of 2026-10-31 - newOverviewHomelab · ProxmoxNetworking in Proxmox: the vmbr0 bridge, VLANs, a private network behind NAT and the firewallA Proxmox host works like a switch inside the computer: the
vmbr0bridge connects the network card to the guests, and each guest is a separate device on the home network with its own MAC and an address from the router. The config is/etc/network/interfaces, applied withifreload -awithout a reboot. VLANs, a private network behind NAT and the firewall are all built around this bridge, so a mistake in it cuts off both the host and every guest.Proxmox VE 9.2: `ifupdown2` 3.3.0, `pve-firewall` 6.0.6, `proxmox-firewall` 1.2.3 · bridge with NAT and port forwarding — `vmbr1` on a 9.2 host - newOverviewHomelab · ProxmoxProxmox VE: what it is, who makes it and who needs it at homeProxmox VE turns one computer into several: KVM virtual machines and LXC containers, each guest with its own system, its own disk and its own network address. It installs from a USB stick instead of a regular OS and is managed from a browser on port 8006. It’s entirely free: the subscription only gives a tested update repository and support. The price is that everything now rests on one host — when it goes down, every VM goes down.Proxmox VE 9.2: `pve-manager` 9.2.21, kernel 7.0.14, QEMU 11.0.3, LXC 7.0, ZFS 2.4.4 · versions and dates — Proxmox VE Roadmap and FAQ as of 2026-10-31
- newManualHomelab · ProxmoxInstalling Proxmox VE 9: USB stick, installer, no-subscription repository and the first updateNine steps from ISO to a host ready for guests: write the USB stick, enable virtualization in the BIOS, install the system, connect the no-subscription repository, update, add an SSH key and check that notifications arrive. The installer wipes the selected disk completely.Proxmox VE 9.2: `pve-manager` 9.2.21, kernel 7.0.14 · repositories and the `local` / `local-lvm` layout — on an installed 9.2 host
- newManualHomelab · ProxmoxAn Ubuntu template with cloud-init in Proxmox: a VM with a key and an address in a minuteTurn the Ubuntu cloud image into a Proxmox template, and cloud-init sets the user, SSH key, address and hostname on a clone’s first boot. No installer needed: a new VM is
qm clone, two lines of settings andqm start, and a minute later you log in with the key. Test servers for guides are made the same way.Proxmox VE 9.2, QEMU 11.0.3: Ubuntu 24.04 and 26.04 templates from cloud images, clones with an address via cloud-init - newManualHomelab · ProxmoxThe first LXC container in Proxmox: Debian from a template, network, SSH by key and a directory shared with the hostA Debian 13 container from a Proxmox template is a small server that starts in a couple of seconds and takes tens of megabytes of memory when idle. Download the template, create an unprivileged container with an address on the home network and an SSH key, mount a host directory into it and install nginx to check. Don’t use such a container for Docker — that’s what a VM is for.Proxmox VE 9.2: LXC 7.0, `pve-container` 6.1.14, template `debian-13-standard_13.6-1`
- newManualHomelab · ProxmoxBackups in Proxmox: a nightly vzdump job, retention and a restore checkThe built-in vzdump copies whole guests every night — disks and config — to a separate disk or a NAS, and a retention rule deletes the excess: 7 daily, 4 weekly, 6 monthly copies. VMs don’t stop, and the guest agent freezes the file system for the duration of the snapshot. A backup you’ve never restored from doesn’t count: the last step is a restore into a new VM.Proxmox VE 9.2, `pve-manager` 9.2.21 · modes, retention and restore — the Proxmox VE Backup and Restore chapter as of 2026-10-31
- newConfigHomelab · ProxmoxA Proxmox virtual machine config line by line: /etc/pve/qemu-server/111.confA VM in Proxmox is a text file
/etc/pve/qemu-server/<number>.conf: CPU, memory, disks, network, cloud-init and snapshots, one line per setting. The UI andqm setwrite it, but it pays to read it yourself: it shows what the VM will get on its next start, where its disks are and what goes into the backup.Proxmox VE 9.2: `qemu-server` 9.2.11, QEMU 11.0.3 — config of a VM from a cloud-init template - newCheat sheetHomelab · ProxmoxProxmox day to day: qm, pct, pvesm, vzdump and logsCommands for the node’s Shell as root.
qmmanages VMs,pctcontainers,pvesmstorages,vzdumpbackups; everything the web UI does is available here too. Refer to a guest by number:101, not by name.Proxmox VE 9.2: `pve-manager` 9.2.21, `qemu-server` 9.2.11, `pve-container` 6.1.14 - newTipHomelab · ProxmoxA Proxmox snapshot isn’t a backup: it’s on the same disk and holds spaceA snapshot before an update rolls back a bad change in seconds, but it lives on the same storage as the guest’s disk: when the disk dies, both the VM and its snapshots are gone. On top of that a snapshot holds on to old blocks, and the longer it lives, the more space it takes. Take a snapshot before a change and delete it once you’re sure everything works; the copy for when things go wrong is a backup on another disk.Proxmox VE 9.2: VM and container snapshots on LVM-thin
- newTipHomelab · ProxmoxDiscard on a VM disk — otherwise Proxmox’s thin pool only growsThe guest deleted 20 GB — it freed the space on its side, but in the
local-lvmthin pool or in ZFS those blocks stay allocated: the storage doesn’t know they’re no longer needed. TRIM from the guest tells it, and the disk’sdiscard=onoption lets TRIM through to the storage. Without it the pool fills up to 100 % and stops every guest on it.Proxmox VE 9.2, LVM-thin; Ubuntu 24.04 guest - newTipHomelab · ProxmoxDocker on Proxmox goes in a VM, not on the host or in LXCDocker on the Proxmox host itself sets the
FORWARDchain policy toDROP, and guests on bridges lose their network. In an LXC container Docker works, but it relies on permissions that break with updates to the kernel, AppArmor and Docker itself. Proxmox explicitly recommends a VM: Ubuntu with Docker inside behaves like any VPS and costs 300–500 MB more memory.Proxmox VE 9.2 · Proxmox VE FAQ: Docker on the host and in containers · containerd 1.7.29 and CVE-2025-52881 — Proxmox forum thread, November 2025 - newTipHomelab · ProxmoxPick the Proxmox node name and address during install: they can be changed later, but in several placesA Proxmox node’s name is the name of the directory holding the configs of all its guests in
/etc/pve/nodes/, and its address must match the entry in/etc/hosts, orpve-clusterwon’t start and the UI is empty. So set the name and a permanent address in the installer. The address can later be changed in five minutes; the name only by moving configs, and in a cluster only by removing the node from the cluster.Proxmox VE 9.2: `pve-cluster` 9.1.6 · node renaming — the Renaming a PVE node page in the Proxmox wiki - newTipHomelab · ProxmoxProxmox host port 8006 and SSH — from your own network onlyThe Proxmox web UI on port 8006 is root to every guest at once: consoles, disks, backups. Don’t forward it to the outside, and on a rented server with a public address close it right after install:
pveproxylets in only your own addresses, and you get in through an SSH tunnel. Plus a second factor forroot@pam.Proxmox VE 9.2: `pveproxy` from `pve-manager` 9.2.21, `/etc/default/pveproxy` - newTipHomelab · Proxmoxqemu-guest-agent in every Proxmox VM, plus the Guest Agent option on the VMThe guest agent is a service inside the VM that Proxmox talks to: it shuts the VM down cleanly, sees its addresses and freezes the file system for the second of the snapshot, so the backup is consistent. Without the agent Proxmox shuts the VM down with an ACPI button the guest may ignore, and the backup looks like a sudden power loss. Install the package in the guest and enable the option on the VM — you need both.Proxmox VE 9.2, Ubuntu 24.04 and 26.04 guests with `qemu-guest-agent`
- newTipHomelab · ProxmoxWithout a subscription: the pve-no-subscription repository, both enterprise ones offA fresh Proxmox points at the enterprise repositories — its own and Ceph’s — and they open only to a host with a subscription key:
apt updatefails with401 Unauthorized, and the host doesn’t get even security fixes. Turn off both enterprise repositories and turn onpve-no-subscription: the packages are the same, they just arrive there earlier.Proxmox VE 9.2 on Debian 13: `.sources` files in `/etc/apt/sources.list.d/`
2026-10-26Monday
- newManualLinux · SSHSSH keys: from ssh-keygen to passwordless loginCreate an ed25519 key with a passphrase on your computer, put the public half into
authorized_keyson the server, and check that the server lets you in with the key. Don’t turn off password login yet — that’s the next step, sshd_config.OpenSSH 10.5 on Windows 11 — client commands run · OpenSSH 9.6 server (Ubuntu 24.04) — server-side steps run on a clean system - newConfigLinux · SSHsshd_config: key-only login, no root, no passwordsYour own file in
/etc/ssh/sshd_config.d/that turns off password and root logins and cuts the time bots get for guessing. The file name matters:sshduses the first value it finds, not the last, and50-cloud-init.confcan silently bring passwords back.OpenSSH 9.6 (Ubuntu 24.04) · OpenSSH 10.2 (Ubuntu 26.04) - newConfigLinux · SSH~/.ssh/config: short names, a key per server, jumping through a serverThe client’s settings file: instead of
ssh -i ~/.ssh/id_ed25519 -p 22 [email protected]you typessh web1, andscp,rsyncand git understand the same name. As on the server, the first value found wins — put the sharedHost *settings at the end.OpenSSH 10.5 on Windows 11 — parsing checked with `ssh -G` · OpenSSH for Windows 9.5p2 — the `ControlMaster` error · OpenSSH 9.6 (Ubuntu 24.04) - changeConfigLinux · SSH~/.ssh/config: short names, a key per server, jumping through a serverThe OpenSSH for Windows error with
ControlPath— verbatim.OpenSSH 10.5 on Windows 11 — parsing checked with `ssh -G` · OpenSSH for Windows 9.5p2 — the `ControlMaster` error · OpenSSH 9.6 (Ubuntu 24.04) - newOverviewLinux · Ubuntu serverA new Ubuntu server: what to set up in the first hour and whyA fresh VPS comes with root, port 22 open and packages as old as the image — bots start guessing the password minutes after boot. The order: access, updates, firewall, system, Docker, brute-force bans. The base is Ubuntu 24.04 LTS; where 26.04 behaves differently, it says so next to it.Ubuntu 24.04 LTS — from working servers · Ubuntu 26.04 LTS — from the release notes and on a test server with 1 GB of RAM
- changeOverviewLinux · Ubuntu serverA new Ubuntu server: what to set up in the first hour and whyUbuntu 26.04 runs on 1 GB of RAM too — only the installer needs 1.5 GB.Ubuntu 24.04 LTS — from working servers · Ubuntu 26.04 LTS — from the release notes and on a test server with 1 GB of RAM
- newConfigLinux · Ubuntu serverzram-tools: compressed swap in memoryThe
zram-toolspackage creates/dev/zram0— swap that lives in memory itself, compressed 2–3 times. It suits a small VPS with a slow disk or a write limit. The whole config is four lines in/etc/default/zramswap, and their defaults differ between Ubuntu 24.04 and 26.04.zram-tools 0.3.3.1 — Ubuntu 24.04, kernel 6.8 · zram-tools 0.3.7 — Ubuntu 26.04, kernel 7.0 - newOverviewLinux · Firewallnftables: the Linux kernel firewall that replaces iptablesnftables is the Linux kernel firewall that has been replacing iptables since 2014: one
nfttool instead of four, one rule for IPv4 and IPv6, address sets inside the kernel, and a config that applies as a whole or not at all. On Ubuntu 24.04 it already runs under ufw and Docker, even if nobody has ever runnft. Write your own rules into your own table and leave the others’ alone.nftables 1.0.9, iptables 1.8.10, kernel 6.8 — Ubuntu 24.04 · wiki.nftables.org, `man nft` · docs.docker.com — Docker 29 with nftables · Docker 29.9 with iptables-nft — Ubuntu 24.04 - newOverviewDocker · Docker EngineDocker: what it is, where it came from and what it costsDocker runs a program together with everything it needs — libraries, interpreter, config — as a separate process on the host’s kernel, with its own file system and its own network. The program arrives as a ready image and installs with one command, and it’s removed without leaving traces in the system. There’s no virtual machine: all containers share one kernel, so startup takes a fraction of a second, but the boundary between containers is thinner than between machines.Docker Engine 29, Compose v5 — Ubuntu 24.04 · history — Docker and Linux kernel release notes
- newOverviewHomelab · TraefikTraefik: what it is and when to pick itTraefik is a reverse proxy: it takes every request to the server on ports 80 and 443 and hands it to a container by site name. It gets and renews Let’s Encrypt certificates on its own, and picks up new containers from labels in their compose files — no proxy config edits, no restart.Traefik 3.7 on a server
- newManualHomelab · TraefikTraefik from scratch: the first service by name, with HTTPSBring up Traefik as its own compose stack, open a test service and memos through it by name with a Let’s Encrypt certificate, and see which changes apply live and which only with a restart. You need a domain, A records pointing at the server, and free ports 80 and 443.Traefik 3.7 · Docker Compose v5.6 · Let’s Encrypt, HTTP-01
- changeManualHomelab · TraefikTraefik from scratch: the first service by name, with HTTPS
aliasHeadersStrategy: deleteon the entry points; after start the log keeps one informational warning, about encoded characters in the path.Traefik 3.7 · Docker Compose v5.6 · Let’s Encrypt, HTTP-01 - changeManualHomelab · TraefikTraefik from scratch: the first service by name, with HTTPSHow long sites are down while Traefik restarts, and what happens when it starts with a broken file in
dynamic/.Traefik 3.7 · Docker Compose v5.6 · Let’s Encrypt, HTTP-01 - newConfigHomelab · Traefiktraefik.yml block by block: what each setting meansTraefik’s static config block by block: what each setting does, its default, and when to change it. Settings that aren’t in the file but are often needed get their own section.Traefik 3.7 · behind the Cloudflare proxy · DNS challenge
- changeConfigHomelab · Traefiktraefik.yml block by block: what each setting means
aliasHeadersStrategy: deleteon both entry points.Traefik 3.7 · behind the Cloudflare proxy · DNS challenge - newManualHomelab · CrowdSecCrowdSec with Traefik behind Cloudflare: two bouncers and X-Forwarded-ForCrowdSec blocks nothing by itself — bouncers do. Set up two: one on the host (nftables) and one in Traefik (a plugin, 403). Sites behind Cloudflare are covered only by the plugin, and only if you tell it correctly whom to trust in
X-Forwarded-For.Traefik 3.7 · CrowdSec 1.6+, bouncer entries — 1.8.1 · crowdsec-bouncer-traefik plugin v1.8.1 · crowdsec-firewall-bouncer 0.0.36 · Cloudflare proxy - changeManualHomelab · CrowdSecCrowdSec with Traefik behind Cloudflare: two bouncers and X-Forwarded-ForEntries with
@incscli bouncers listcan’t be deleted by name —pruneremoves the leftovers.Traefik 3.7 · CrowdSec 1.6+, bouncer entries — 1.8.1 · crowdsec-bouncer-traefik plugin v1.8.1 · crowdsec-firewall-bouncer 0.0.36 · Cloudflare proxy - newCheat sheetHomelab · CrowdSeccscli and bouncers: everyday commandsWho is banned and why, how to unban your own address, whether a bouncer is alive, what CrowdSec reads from the logs. If CrowdSec runs in a container, prefix every
cscliwithdocker exec crowdsec; on the host, no prefix is needed.CrowdSec 1.6+ in a container · CrowdSec 1.8.1 (bouncers) · crowdsec-firewall-bouncer 0.0.36 - newManualHomelab · SecretsSecrets in Docker stacks: where to keep them and how not to leak themA secret is stored on the server as a single copy that only root can read: no copies in git, on the command line or in other containers’ environment. The default place is a file in
/srv/secrets/<stack>/, attached as a Docker secret; if the app can’t do that, a.envwith mode 600.Docker Compose v5.6 (secrets without Swarm) · Traefik 3.7 · MariaDB 12.3 - newRecipeHomelab · Server changesDeploy without SSHMake changes only in git on your computer: every 10 minutes the server pulls new commits on its own and restarts the stacks that changed, and a stack that fails to come up is rolled back together with its commit. Renovate sends new image versions as pull requests — merge them, and the server deploys them itself. A failed deploy or a silent one raises an alert in ntfy through Healthchecks.io.Ubuntu 24.04 · git 2.43 · Docker Compose v2 · Healthchecks.io · Renovate (GitHub App)
- newRecipeHomelab · Server changesMoving to a new serverPut everything set up on levels 1–5 into git:
/optbecomes a repository, and system files go into/opt/host. On an empty VPS at any host, one script brings up the server’s base, and a second one restores stacks from the Kopia backup: all of them, several, or one. Test it with a drill on a temporary VPS, and move when the time comes.Ubuntu 24.04 · Kopia 0.23 · git 2.43 · GitHub: private repositories, deploy keys - newManualHomelab · LogsTraefik logs: CrowdSec, vector, Loki, rotationTraefik’s access log is the main source both for protection (CrowdSec) and for working out what happened (Loki and Grafana). It’s read directly or through vector, which splits the log by service and drops the noise. Every reader remembers where it stopped, and every file has exactly one rotation mechanism.Traefik 3.7 (JSON access log) · CrowdSec 1.8.1 · vector (timberio/vector:latest-alpine) · Loki and Promtail 3.1 · Grafana 11 · logrotate
- changeRecipeHomelab · BackupsA backup that outlives the serverA whole new server, base and stacks by script — a link to the Moving to a new server recipe.Ubuntu 24.04 · Kopia 0.23 · rclone 1.60
- newOverviewHomelab · MikroTikWired networking on MikroTik: bridge, switch chip, fasttrack and VLANsInside the home network, traffic between ports of one bridge is switched by the switch chip — at port speed and bypassing the CPU. Toward the internet every packet goes through the CPU and the firewall, and fasttrack holds the speed there: already allowed connections bypass the rules. Most “why is it slow” questions are about which of the two paths the traffic takes.RouterOS 7.24 as of 2026-10-19 · CHR 7.24 — recursive route: failover and return · speed figures — MikroTik’s tests from the model pages
- changeOverviewHomelab · MikroTikWired networking on MikroTik: bridge, switch chip, fasttrack and VLANsA recursive route example for two ISPs — in “Two ISPs”.RouterOS 7.24 as of 2026-10-19 · CHR 7.24 — recursive route: failover and return · speed figures — MikroTik’s tests from the model pages
- newManualHomelab · MikroTikFirst MikroTik setup: internet, your own user, updates, Wi-Fi and a backupNine steps from the box to a router you can trust with your home: log in, connect the ISP, create your own user, update RouterOS and the bootloader, set the country and Wi-Fi password, close unneeded services, save a copy. Leave the default firewall alone — it already protects the network.hAP ax² with the factory config, RouterOS 7.23 and 7.24 as of 2026-10-19 · CHR 7.24 — `/ip service` and the commands of “Close unneeded services”
- changeManualHomelab · MikroTikFirst MikroTik setup: internet, your own user, updates, Wi-Fi and a backupThe
/ip servicelisting matches 7.24:reverse-proxy, dynamic rows, theAVAILABLE-FROMcolumn.hAP ax² with the factory config, RouterOS 7.23 and 7.24 as of 2026-10-19 · CHR 7.24 — `/ip service` and the commands of “Close unneeded services” - newManualHomelab · MikroTikA guest Wi-Fi network on MikroTik: a separate bridge, its own DHCP and three firewall rulesGuests and smart plugs get their own network,
192.168.89.0/24: internet yes, computers, the NAS and the router itself no. On a single router without access points this needs no VLANs: virtual Wi-Fi networks on both radios, a separate bridge and three firewall rules. Make the changes in Safe Mode.hAP ax² with the factory config, RouterOS 7.24, the wifi-qcom package as of 2026-10-19 - changeManualHomelab · MikroTikA guest Wi-Fi network on MikroTik: a separate bridge, its own DHCP and three firewall rulesOn 7.24
/ip dhcp-server addcreates the server enabled — the cause in “If it doesn’t work” is fixed.hAP ax² with the factory config, RouterOS 7.24, the wifi-qcom package as of 2026-10-19 - newTipHomelab · MikroTikEdit the MikroTik firewall and bridge in Safe ModeBefore a change that can cut you off from the router — firewall, bridge, VLANs, addresses — turn on Safe Mode: Ctrl+X in the terminal or the button in Winbox. If the connection drops, RouterOS rolls back everything done in this mode.RouterOS 7.24 as of 2026-10-19
- changeTipHomelab · MikroTikEdit the MikroTik firewall and bridge in Safe ModeThe prompt when Safe Mode is taken — verbatim, as in 7.24.RouterOS 7.24 as of 2026-10-19
- newManualAI · Local modelsA model on your own hardware: Ollama, an API on port 11434 and a web UIOllama downloads an open model, runs it on a GPU or CPU and serves an API on port 11434 — including one compatible with OpenAI. Next to it goes Open WebUI, a chat in the browser. Your data goes nowhere, but the model is weaker than cloud flagships and is limited by memory. Ollama has no password: don’t open the port to the outside.Ollama 0.40.6 — the version on GitHub as of 2026-10-16 · GPUs — Ollama docs/gpu.mdx, sizes — ollama.com/library and image registries as of 2026-10-26 · Docker 29, Compose v5.6 · Open WebUI
- changeManualAI · Local modelsA model on your own hardware: Ollama, an API on port 11434 and a web UIWhat to try it on and what to work on: memory, disk, GPUs.Ollama 0.40.6 — the version on GitHub as of 2026-10-16 · GPUs — Ollama docs/gpu.mdx, sizes — ollama.com/library and image registries as of 2026-10-26 · Docker 29, Compose v5.6 · Open WebUI
2026-10-25Sunday
- changeConfigLinux · SSHsshd_config: key-only login, no root, no passwordsThe file is the same as in the New server recipe, without the opening comment.OpenSSH 9.6 (Ubuntu 24.04) · OpenSSH 10.2 (Ubuntu 26.04)
- changeOverviewLinux · Ubuntu serverA new Ubuntu server: what to set up in the first hour and whyDocker before brute-force bans: why it belongs in the first hour.Ubuntu 24.04 LTS — from working servers · Ubuntu 26.04 LTS — from the release notes and on a test server with 1 GB of RAM
- newConfigLinux · Ubuntu serverunattended-upgrades: security updates on their own and a reboot at 4:00Ubuntu Server already has automatic updates on, but without reboots: a new kernel gets installed and waits until someone restarts the server by hand. Your own
52unattended-upgrades-localfile turns on a 4:00 reboot and old-kernel cleanup, and deliberately keeps the Docker repository out of auto-updates.unattended-upgrades 2.9 (Ubuntu 24.04) — from the package’s file · Ubuntu 26.04 - changeConfigLinux · Ubuntu serverunattended-upgrades: security updates on their own and a reboot at 4:00Your own file is the same as in the New server recipe.unattended-upgrades 2.9 (Ubuntu 24.04) — from the package’s file · Ubuntu 26.04
- newRecipeLinux · Ubuntu serverNew server: the first hourTurn an empty VPS into a server you can leave on the internet: your own user with key-only login, a firewall, updates with a nightly reboot, swap, a journal limit and Docker. The why is in the manuals, linked from every stage.Ubuntu 24.04 LTS · Ubuntu 26.04 LTS · Docker Engine 29, Compose v5.6
- newRecipeHomelab · TraefikA service over HTTPS: Traefik and the first serviceBring up Traefik as its own stack and expose memos through it by name with a Let’s Encrypt certificate. The why is in the manuals, linked from every stage.Ubuntu 24.04 · Docker Engine 29, Compose v5.6 · Traefik 3.7 · Let’s Encrypt, HTTP-01
- newRecipeHomelab · CrowdSecProtection: brute-force bans and closed portsCrowdSec in a container spots SSH brute force in
auth.log, and a bouncer on the host bans the address in nftables on every port, containers included. Then check from outside that only 22, 80 and 443 are open. The why is in the manuals, linked from every stage.Ubuntu 24.04 · CrowdSec 1.6+ in a container · crowdsec-firewall-bouncer 0.0.36 (nftables) - newManualHomelab · CrowdSecCrowdSec against SSH brute force: a ban across the whole serverCrowdSec in a container reads
/var/log/auth.log, recognizes password and key guessing and decides on a ban, andcrowdsec-firewall-bounceron the host drops packets from that address in nftables — on every port, sites in Docker included. The setup comes from production servers; Traefik and Cloudflare aren’t needed here — with them, see CrowdSec with Traefik behind Cloudflare.CrowdSec 1.6+ in a container · crowdsec-firewall-bouncer 0.0.36 (nftables) · Ubuntu 24.04 · config from a production server - changeManualHomelab · CrowdSecCrowdSec against SSH brute force: a ban across the whole serverThe stack follows the server profile:
docker-compose.yaml, data indata/; compose, source and profiles are the same files as in the Protection recipe.CrowdSec 1.6+ in a container · crowdsec-firewall-bouncer 0.0.36 (nftables) · Ubuntu 24.04 · config from a production server - changeManualHomelab · CrowdSecCrowdSec with Traefik behind Cloudflare: two bouncers and X-Forwarded-ForCrowdSec volumes live in the stack’s
data/, as in CrowdSec against SSH brute force and the server profile.Traefik 3.7 · CrowdSec 1.6+, bouncer entries — 1.8.1 · crowdsec-bouncer-traefik plugin v1.8.1 · crowdsec-firewall-bouncer 0.0.36 · Cloudflare proxy - newManualHomelab · Server changesServer configs in git: /opt as the repositoryEvery compose file and config on the server lives in a private git repository whose root is
/optitself. Edit on your computer; on the server, onlygit pull. Secrets and data never leave the server:.gitignoreis an allowlist, and before the first commit a check looks for secrets without printing them.Ubuntu 24.04 · git 2.43–2.53 · Docker Compose v5.6 · GitHub: private repositories, deploy keys - changeManualHomelab · Server changesServer configs in git: /opt as the repositoryCrowdSec configs in
.gitignorefollow the new stack layout:crowdsec/data/config/.Ubuntu 24.04 · git 2.43–2.53 · Docker Compose v5.6 · GitHub: private repositories, deploy keys - newRecipeHomelab · MonitoringMetrics, uptime checks and alertsBeszel shows what the server and its containers are busy with, Gatus opens your services over HTTPS once a minute, and Healthchecks.io waits outside for a heartbeat from the server: if it goes quiet, the server is down. All three send their alerts to your phone through ntfy.Ubuntu 24.04 · Beszel 0.21 · Gatus 5.37 · Healthchecks.io · ntfy.sh
- newRecipeHomelab · BackupsA backup that outlives the serverEvery night the server dumps the memos database, and Kopia snapshots
/optand/srv/secrets, encrypts the snapshot and sends it to a second server over SFTP or to Google Drive. Healthchecks.io waits for a ping after each backup, and once a week the server restores the database from storage and checks it on its own.Ubuntu 24.04 · Kopia 0.23 · rclone 1.60
2026-10-24Saturday
- changeOverviewLinux · Ubuntu serverA new Ubuntu server: what to set up in the first hour and whyRemoved the “In order” step — the set’s commands on one screen.Ubuntu 24.04 LTS — from working servers · Ubuntu 26.04 LTS — from the release notes and on a test server with 1 GB of RAM
- changeConfigLinux · Ubuntu servercloud-init: a server configured the moment it’s createdThe outside check is here now, not a link to the command list.cloud-init 24.x–25.x (Ubuntu 24.04 and 26.04)
- newOverviewDevelopment · ObsidianObsidian: what it is and how it stores notesObsidian is a note editor on top of a regular folder: a note is a
.mdfile, a connection between notes is a[[…]]link. On top of that the app adds backlinks, search across the whole vault, properties and plugins. The files stay readable without Obsidian: any editor opens them,grepfinds them, git stores them.Obsidian 1.11.7 (Windows) — defaults and setting names taken from the app itself · the rest — from the Obsidian help as of October 2026
2026-10-23Friday
- newTipLinux · FirewallDocker ports bypass the input chainA firewall rule in
inputdoesn’t touch containers with published ports: after DNAT their traffic goes throughforward. For a ban to cover the whole server, put the rule in bothinputandforward.Ubuntu 24.04 · Docker with iptables-nft · nftables · crowdsec-firewall-bouncer 0.0.36 - changeTipLinux · FirewallDocker ports bypass the input chainWhat a hook is — a paragraph under the packet diagram.Ubuntu 24.04 · Docker with iptables-nft · nftables · crowdsec-firewall-bouncer 0.0.36
- changeConfigHomelab · Traefiktraefik.yml block by block: what each setting meansThe crowdsec-bouncer-traefik plugin is now v1.8.1.Traefik 3.7 · behind the Cloudflare proxy · DNS challenge
- changeManualHomelab · CrowdSecCrowdSec with Traefik behind Cloudflare: two bouncers and X-Forwarded-ForPlugin v1.8.1; how to remove stale entries from
cscli bouncers list.Traefik 3.7 · CrowdSec 1.6+, bouncer entries — 1.8.1 · crowdsec-bouncer-traefik plugin v1.8.1 · crowdsec-firewall-bouncer 0.0.36 · Cloudflare proxy - changeTipHomelab · MikroTikEdit the MikroTik firewall and bridge in Safe ModeWhat happens if Safe Mode is already on in another session.RouterOS 7.24 as of 2026-10-19
- newTipHomelab · MikroTikRouter Winbox, WebFig and SSH — from the home network onlyDon’t expose MikroTik management to the outside: not Winbox, not the web UI, not SSH. Nearly every loud MikroTik compromise — 2018, 2021, September 2026 — went through management services open to the internet. Close them with two layers: the firewall and
address=on each service.RouterOS 7.24 — from the September 2026 vulnerability bulletin on mt.lv - changeTipHomelab · MikroTikRouter Winbox, WebFig and SSH — from the home network onlyHow to check when the router is behind the ISP’s NAT.RouterOS 7.24 — from the September 2026 vulnerability bulletin on mt.lv
- newTipHomelab · MikroTikUpdated RouterOS? Update the RouterBOOT bootloader tooRouterOS and the RouterBOOT bootloader update separately. After
installthe system is new, but the bootloader stays old until you run/system routerboard upgradeand reboot once more. To make it automatic, turn onauto-upgrade=yes.RouterOS 7.24 as of 2026-10-19 - changeTipHomelab · MikroTikUpdated RouterOS? Update the RouterBOOT bootloader tooWhat a bootloader is — in the first paragraph.RouterOS 7.24 as of 2026-10-19
2026-10-22Thursday
- changeOverviewDevelopment · PythonPython: where it came from, why it became the language of AI, and where to start“Where to start” leads to the Python section: chapters in order, and practice — one-evening tasks.Python 3.15.1 (Windows) — commands and examples run · NumPy 2.5.4 — matrix multiplication measured · shares and rankings — W3Techs as of 2026-10-21, TIOBE, GitHub Octoverse 2024 and 2025 · history — the FAQ on docs.python.org
- newOverviewDevelopment · PythonRunning Python: the interactive mode and your own .py fileThere are three ways to run Python: interactively — type a line, see the answer right away; as a
.pyfile — the code is saved and runs as many times as you like; as a module by name —python -m. Work out in the terminal how much an uncompressed video frame weighs, and save the calculation as your first script.Python 3.15.1 (Windows) — files, `-m calendar`, error messages · interactive mode — via `python -i`; `exit` without parentheses in 3.13 - newOverviewDevelopment · PythonVariables and types: a name, a value, and what you can do with itA variable is a name you gave a value:
size_gb = 4.7. The type belongs to the value, not the name: a number adds, a string concatenates, and"4.7" * 2is4.74.7. Work out how long a disk image takes to download, and see why keyboard input is always a string.Python 3.15.1 (Windows) — examples, output and error messages run - newOverviewDevelopment · PythonNumbers in Python: integers without a limit, fractions with an errorPython has two kinds of numbers. Integers (
int) have any length and are exact. Fractions (float) carry an error, which is why0.1 + 0.2is0.30000000000000004. Convert a server’s uptime from seconds into days and hours, go through division, remainder and rounding, and find out where 69 GB of a 1 TB disk went.Python 3.15.1 (Windows) — examples, output and error messages run - newOverviewDevelopment · PythonStrings in Python: slices, methods and f-stringsA string is text in quotes, a row of characters numbered from zero. A slice takes a piece by position, methods search, change case and trim spaces, and an f-string builds text out of values. Pull the shooting date and the extension out of the photo name
IMG_20261021_183045.jpg— and find out why the pathD:\newprints with a line break.Python 3.15.1 (Windows) — examples, output and error messages run - newOverviewDevelopment · PythonConditions in Python: if, elif and what counts as false
ifruns a block only when the condition is true;elifandelsewhen it isn’t. A condition can be any value: a comparison givesTrueorFalse, and an empty string, zero andNonecount as false. Write a disk check that says whether it’s time to clean up, and see whyif x == 1 or 2is always true.Python 3.15.1 (Windows) — examples, output and error messages run; `shutil.disk_usage` — on drive `C:` - newOverviewDevelopment · PythonLoops in Python: for over anything, while until a condition, break
forwalks through a collection — lines of text, characters, numbers fromrange— and runs a block for each.whilerepeats while a condition is true.breakleaves the loop early,continueskips a step. Count the errors in a log, and make retry pauses that double each time.Python 3.15.1 (Windows) — examples, output and error messages run - newOverviewDevelopment · PythonFunctions in Python: def, arguments and returnA function is a named piece of code: write it once, call it as many times as you like with different values.
defcreates it, arguments pass data in,returnhands the result out. Writehuman_size— bytes in words, the way a file manager shows them: 4.4 GB, 512.0 KB — and see why a function withoutreturnsilently givesNone.Python 3.15.1 (Windows) — examples, output and error messages run - changeManualDevelopment · PythonA 120-bit password from your own script: the first .py file and the secrets moduleThe
.pyfile, variables and functions in detail — in the “Running Python”, “Variables and types” and “Functions” chapters.Python 3.15.1 (Windows) — script and output run - changeManualDevelopment · PythonPython from scratch: install it and send files to your phone over Wi-FiRunning
pythonandpython -min detail — in the section’s “Running Python” chapter.Python 3.15.1 (Windows) — server started, file list served · Ubuntu 24.04, macOS · Android — file and folder list, downloads, `.md` opens as text - changeManualDevelopment · PythonSort Downloads into folders: a script with a dry runConditions and loops in detail — in the Python section’s “Conditions” and “Loops” chapters.Python 3.15.1 (Windows) — dry and real runs on a test folder
- changeManualDevelopment · PythonWhat’s taking up disk space: the biggest files in one scriptSlices and f-strings in detail — in the Python section’s “Strings” chapter.Python 3.15.1 (Windows) — the home folder and the Python folder
- newOverviewDesign · Presenting informationPresenting information: how people read a screen and what follows from itA page is hardly ever read straight through: the eye goes over headings, the first words of lines and whatever is highlighted, and stops where an answer seems to be. Presentation is laying the text out for that path: the answer on top, headings that say what’s inside, short chunks, groups separated by white space, one or two highlights per screen.NN/g research 1997–2019 — from their articles · WCAG 2.2 — from the standard’s text · column width — measured in Edge 155, Golos 17px
- changeOverviewDesign · Presenting informationPresenting information: how people read a screen and what follows from itLine length and alignment moved to the “Typography” set, contrast to “Color”; they remain in the rules table as links.NN/g research 1997–2019 — from their articles · WCAG 2.2 — from the standard’s text · column width — measured in Edge 155, Golos 17px
- newOverviewDesign · TypographyTypography: typeface, size and the line on screenText readability on screen rests on four settings — typeface, font size, line height and line length — plus typesetting rules: curly quotes, dashes, non-breaking spaces. Pick a typeface that covers your languages and has tall lowercase letters, and tune the size to the typeface instead of copying it from someone else’s CSS: at the same 17 px, Times New Roman’s lowercase is 15% shorter than Golos’s.this site’s fonts and CSS (`astro.config.mjs`, `src/styles/`) · x-height, text width and figures — measured in Edge 155 · CSS support — per MDN data
- newConfigDesign · TypographyYour own font on a site: @font-face, subsets and loading without a jumpServe your own font as a
woff2file from your own site: one variable file gives every weight, each script comes as a separate subset, and the fallback font is matched by its metrics — when your font arrives, the text doesn’t jump. Here’s the CSS that Astro builds for this site, line by line.Astro 7.4, `fonts` in `astro.config.mjs` — CSS and files from this site’s build · the Google Fonts CSS API response (`fonts.googleapis.com/css2`) · `size-adjust` and `*-override` support — per MDN data - newOverviewDesign · ColorColor: a palette by role, contrast and dark modeOn screen, color tells things apart: text levels, links, states, categories. Build the palette by role — backgrounds, three levels of text, lines, one accent, states — compute the contrast of every text–background pair, give dark mode its own set of the same tokens, and never let meaning rest on color alone.this site’s colors — `src/styles/tokens.css` · contrast and OKLCH computed with the WCAG 2.2 and OKLab formulas · WCAG 2.2 — from the standard’s text · CSS support — per MDN data
- newConfigDesign · ColorA palette in CSS: role-based tokens for the light and dark themesDefine colors once — as role-based variables in
:root— and let components use onlyvar(--…). Dark mode is the same names with other values: it turns on by system setting or by toggle, and a small script in<head>applies the choice before the first paint. Here’s this site’s tokens file, line by line.this site’s `src/styles/tokens.css` and the theme script in `src/layouts/Base.astro` · contrast computed with the WCAG 2.2 formula · `light-dark()` and `color-scheme` support — per MDN data
2026-10-21Wednesday
- newOverviewDevelopment · PythonPython: where it came from, why it became the language of AI, and where to startPython started in 1989 as a language for system administration — so you didn’t have to choose between a C program and a shell script. Today neural networks are trained and data is crunched in it, although most websites still run on PHP. Here’s what’s special about the language, how the leaders changed and why, where Python is weak, and why models increasingly solve a task by writing a script.Python 3.15.1 (Windows) — commands and examples run · NumPy 2.5.4 — matrix multiplication measured · shares and rankings — W3Techs as of 2026-10-21, TIOBE, GitHub Octoverse 2024 and 2025 · history — the FAQ on docs.python.org
- newManualDevelopment · PythonA 120-bit password from your own script: the first .py file and the secrets moduleWrite your first
.pyfile: two functions that produce a 20-character password and a PIN. The randomness comes from thesecretsmodule — made for passwords and keys, unlikerandom. 20 characters out of 64 is 120 bits: no brute force will guess such a password.Python 3.15.1 (Windows) — script and output run - newManualDevelopment · PythonA QR code for guest Wi-Fi: your first pip package in a virtual environmentMake an image a guest scans with a phone camera to join the Wi-Fi without typing the password. The code is drawn by the
qrcodepackage — it isn’t in the standard library, so for the first time you install a package: into the folder’s virtual environment, so it doesn’t mix with the system Python.Python 3.15.1 (Windows), qrcode 8.2, Pillow 13.0 — PNG and the code in the terminal - newManualDevelopment · PythonAre the sites up: a list check and errors handled with try/exceptThe script walks through a list of URLs and prints each one’s status code and response time, or the reason there’s no answer:
404 Not Found, no connection, a timeout. One unreachable page doesn’t stop the checks of the rest —try/exceptcatches the errors. Standard library only, no packages.Python 3.15.1 (Windows) — `example.org`, a 404 page, a nonexistent domain - newManualDevelopment · PythonDuplicate photos by content: a hash and a dictionary as memoryThe script finds identical files even when their names and folders differ:
IMG_2041.jpg,IMG_2041 (1).jpgand a copy from the phone. It compares content by SHA-256 hash and reads only files whose sizes match. It deletes nothing — it prints the groups, and you decide.Python 3.15.1 (Windows) — a test folder with copies - newManualDevelopment · PythonPython from scratch: install it and send files to your phone over Wi-FiInstall Python and, with one command,
python -m http.server, open a computer folder to a phone on the same network: the phone shows a page listing the files, tap one and it downloads. No cable, no cloud, and no code of your own.Python 3.15.1 (Windows) — server started, file list served · Ubuntu 24.04, macOS · Android — file and folder list, downloads, `.md` opens as text - newManualDevelopment · PythonSort Downloads into folders: a script with a dry runThe script moves files from Downloads into Images, Documents, Archives and other folders by extension. At first it only prints a plan and touches nothing; it moves files once you flip one line. It never overwrites: if the folder already has a file with that name, it skips it.Python 3.15.1 (Windows) — dry and real runs on a test folder
- newManualDevelopment · PythonWhat’s taking up disk space: the biggest files in one scriptThe script walks a folder with everything inside, collects file sizes into a list, sorts it and prints the 15 biggest with their size in KB, MB, GB. A Windows home folder — 79 thousand files, 16 GB — takes 15 seconds. The script deletes nothing; it only shows.Python 3.15.1 (Windows) — the home folder and the Python folder
2026-10-20Tuesday
- newManualLinux · Ubuntu serverSwap, journal and time: three settings for a small VPSA 2 GB swap file so a memory spike doesn’t end in
Out of memory; a 500 MB cap on the systemd journal so it doesn’t eat the disk; a check that the clock syncs — timesyncd on 24.04, chrony with NTS on 26.04.Ubuntu 24.04 LTS, ext4 · Ubuntu 26.04.1 LTS, chrony 4.8 — time and a closed TCP 4460 tested on a server - changeManualLinux · Ubuntu serverSwap, journal and time: three settings for a small VPS
chronyc -N authdataoutput on 26.04 — both working and with TCP 4460 closed; a new case in “If it doesn’t work”.Ubuntu 24.04 LTS, ext4 · Ubuntu 26.04.1 LTS, chrony 4.8 — time and a closed TCP 4460 tested on a server - newConfigLinux · systemdsystemd: delayed, one-by-one start of compose stacksOn a weak server, containers that all start at once after boot get in each other’s way: the database doesn’t come up in time, and apps crash on connect. A systemd unit waits for Docker, pauses, and starts the stacks one at a time.Ubuntu 24.04 · systemd · Docker Compose v5.6
- changeConfigLinux · systemdsystemd: delayed, one-by-one start of compose stacksThe script moved from
/opt/_softstart/to/opt/scripts/.Ubuntu 24.04 · systemd · Docker Compose v5.6 - newTipDocker · Docker EngineWho owns WordPress files in Docker: www-data and uid 33WordPress files belong to whoever runs PHP in the container:
www-data, uid 33 in Debian-based images and 82 in-alpine. Hand the mounted directory to that user with onechown— on the host the number matters, not the name.Docker 29.1, Ubuntu 26.04 — `userns-remap` · `wordpress:apache` image, WordPress 7.0 → 7.1.3, WP-CLI 2.12 - changeManualHomelab · Server changesServer configs in git: /opt as the repositoryWhere to keep stacks:
/opt,/srvor~/docker; server-wide scripts go in/opt/scripts/.Ubuntu 24.04 · git 2.43–2.53 · Docker Compose v5.6 · GitHub: private repositories, deploy keys
2026-10-19Monday
- newTipAI · PromptsConsistent answers come from format and checks, not temperature 0A model picks the next token with some randomness, so one question gives different wordings.
temperature: 0never removed that completely even where it existed, and on Claude Opus 4.7 and newer the parameter is gone. Get repeatability from a strict answer format, a schema and a scripted check of the result.Claude API as of 2026-10 · Ollama — options.temperature - newTipAI · PromptsWhich language to prompt in: non-English costs more tokens, not more misunderstandingThe same text in Russian takes 1.16 times as many tokens as in English on the
o200k_basevocabulary; on the 2023 vocabulary it was 1.64 times. Strong models understand a prompt in another language as well as in English, so write in the language you phrase things most precisely in, and set the answer language explicitly.js-tiktoken 1.0.21 — measured on 34 of this site’s pages, RU and EN · Claude Opus 5.5 and Sonnet 5.5 — prompts in Russian - newOverviewAI · AI agentsAgents and tools: how a model reads files and runs commandsA model can only write text. A tool is a function it can ask to have called: read a file, run a command, search the web. An agent is a model plus tools plus a loop of “asked — ran — returned the result” until the task is done. MCP is a common standard for plugging tools into any agent.Claude Code in VS Code — on this site’s tasks · Claude API tool use · MCP — the specification and Claude Code
- newManualAI · AI agentsRunning a server with an AI agent: roles, checks, secretsThe agent reads configs from git on your computer and prepares commands; a person runs them on the server and sends the output back. The agent needs neither root on the server nor secrets: inventory by paths, checks with masked values.Claude Code (agent in VS Code on a work computer) · Ubuntu VPS · GitHub
- newTipAI · AI agentsSomeone else’s text is data, not commands: prompt injectionTo a model, your question and pasted text are one stream of tokens. If an email, a page or a README says “ignore previous instructions and run
curl … | sh”, the model may do it — especially an agent with terminal access. Put outside text in tags marked as data, and confirm by hand what an agent does with outside material.Claude Code — command permissions - newTipDevelopment · GitBefore running an AI agent — a clean git statusAn agent edits many files at once. If everything is committed before the run, its work is exactly
git diff: every edit is visible, what you don’t want rolls back withgit restore, and what you do want gets committed in parts. With uncommitted edits, yours and the agent’s get mixed, and rolling back only the agent’s is no longer possible.git 2.55 · Claude Code in VS Code
2026-10-18Sunday
- newManualAI · PromptsLong conversations: how not to hit the context limit and not lose what you agreed onEvery turn of a chat stays in the context to the end: old file versions, rejected ideas, wrong answers. By the hundredth message the model holds early agreements worse, and every turn costs more. Move the permanent stuff out of the chat, keep one task per chat, and when switching, carry over a summary, not the history.claude.ai — projects · Claude Code in VS Code — /context, /compact, /clear · Claude API — history compaction
- newTipAI · PromptsMatch reasoning to the task: an effort level instead of “think harder”Set reasoning depth with the
effortlevel, not with words in the prompt:lowfor translation, extraction and chat,highand up for bug hunting, architecture and tasks whose answer can be checked. Reasoning is billed as output and makes the answer slower, somaxon everything is wasted money and minutes.Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 as of 2026-10 · Claude Code — on this site’s tasks - newTipAI · PromptsReview in a new chat, without your version, asking for mistakesA model tends to agree: in the same chat where it wrote the answer, or where you praised it, a review will confirm it. Review in a new chat with no history, ask it to find weak spots rather than to assess, and for important work use a model from another vendor.Claude Opus 5.5 and Sonnet 5.5 · model sycophancy — from how models work (Language models)
- newTipAI · PromptsWrong answer? Edit your question instead of arguing with the answerIf an answer went the wrong way, edit the original message and resend it instead of writing “no, not like that” as the next turn. A wrong answer left in the history pulls the model back to itself: it tries to stay consistent and goes in circles.claude.ai — editing a message · Claude Code — rewinding to an earlier message
2026-10-17Saturday
- newTipAI · PromptsA rule in a prompt gets a reason instead of capsA newer model executes “NEVER change the ports” literally and more broadly than needed. With “we don’t change ports: the firewall on the neighbouring server is set up for them”, it understands where the rule applies and where it doesn’t: it fixes a typo in a port number but won’t swap
8080for8081without asking.Claude Opus 5.5 and Sonnet 5.5 · Anthropic’s prompting recommendations for 5.x models - newTipAI · PromptsLong document first, question last, answer with quotesPut a document of dozens of pages at the start of the prompt and the question after it, and ask the model first to write out the quotes its answer relies on. That way it answers from the text rather than from memory, and every claim can be checked against the document.Claude Opus 5.5 and Sonnet 5.5 · Anthropic’s long-context recommendations
- newTipAI · PromptsNeed a particular kind of answer? Show an example instead of describing itOne example of the answer you want sets length, tone, detail and format more precisely than a paragraph of description. For different cases, give two or three examples unlike each other, or the model will copy what they have in common, accidents included.Claude Opus 5.5 and Sonnet 5.5
- newTipAI · PromptsNew task, new chatA conversation about Traefik, then backups, then an email to a colleague, all in one chat, is a context where every new task drags the tails of the earlier ones along: other files, cancelled decisions, tone. A new topic gets a new chat, and what’s needed from the old one moves over as a summary.claude.ai · Claude Code — /clear
- newTipAI · PromptsPut the date, versions and environment in the promptThe model doesn’t know today’s date, which version of a program you have, or what came out after its knowledge cutoff. Write it yourself: “today is 2026-10-18, Ubuntu 24.04, Docker 29, Traefik 3.7”. Without it, the answer is for whichever version had the most text in training.Claude Opus 5.5 and Sonnet 5.5
2026-10-16Friday
- newConfigAI · PromptsA prompt, block by block: context, materials, task, format, examplesA prompt works when it holds what the model can’t guess: who the result is for, what to base it on, what counts as done and in what form to deliver it. Here’s a prompt for reviewing a compose file, block by block; at the end, habits from 2023 that get in the way of newer models.Claude Opus 5.5 and Sonnet 5.5 · Anthropic’s prompting recommendations for 5.x models
- newTipAI · PromptsA big task: questions and a plan first, then the workBefore a big task, ask the model not to act but to ask what’s missing and propose a plan. Five minutes of answers save an hour of rework: a model that starts right away fills the gaps with guesses, and fixing guesses costs more than a question.Claude Opus 5.5 — claude.ai and Claude Code (plan mode)
- newCheat sheetAI · Local modelsHow much memory a model needs: parameters, quants, context and speedMemory for a model is the weights (parameters × bits per weight) plus the context cache, which grows with the conversation, plus 1–2 GB of overhead. Generation speed is bound by memory bandwidth: every token reads all the weights. Formulas and tables to estimate before downloading 40 GB.calculated from formulas; quant sizes are GGUF averages · Llama 3.1 8B and 70B architecture — from their configs · speed — the theoretical ceiling, not measured on hardware
2026-10-15Thursday
- newManualAI · Tokens and costTokens: measuring text size and the price of a requestA model reads and writes in tokens — pieces of words. Text in other languages is often longer in tokens than the same text in English (Russian by 16%), and you pay for every input and output token, reasoning included. Count the tokens in your text, the price of one request and the price of an agent’s work — before the bill arrives.js-tiktoken 1.0.21, o200k_base and cl100k_base — measured on 34 of this site’s pages · Claude API count_tokens · Node.js 24
- newTipAI · Tokens and costA subscription for hands-on work, the API for programsA chat subscription (claude.ai, ChatGPT, Gemini) is a fixed monthly sum for work in the app and the agent, with a message limit per time window. The API charges per token, with no message limit but no price ceiling either. For yourself and your own work — a subscription; for a script, a bot, anything that runs without you — the API with a spending limit.claude.ai, ChatGPT and Gemini plans — from their pages as of 2026-10-20 · API prices — Models as of October 2026
- newTipAI · Tokens and costNon-urgent API requests go as a batch at half priceLabelling three thousand notes, translating an archive, running a check over every page — none of it needs to happen in a second. The batch APIs from Anthropic, OpenAI and Google cost half the regular price and answer within 24 hours, usually within an hour.Claude Message Batches API as of 2026-10 · OpenAI and Gemini batch prices — their pricing pages as of 2026-10-18
- newTipAI · Tokens and costPrice a model by the solved task, not the tokenA cheap model that needs three attempts and your correction costs more than a strong one that got it right the first time. Compare models and
effortlevels on your own tasks by cost and time to a finished result — and often a strong model on loweffortbeats a weak one on high.Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 — prices per Models as of October 2026 · Anthropic’s recommendations on choosing effort - newTipAI · Tokens and costThe constant part of a prompt goes first, under the cacheThe prompt cache keeps the start of a request for 5 minutes (or an hour): a repeat request with the same start reads it at 10–40 times less than regular input and answers faster. It only works on a byte-for-byte match, so the constant parts — tools, system prompt, documents — go first, and the date, user name and question go last.Claude API — prompt caching as of 2026-10 · prices — Models as of October 2026
2026-10-14Wednesday
- newManualAI · Model APIsFirst API request: a key that stays out of history, curl, the response and the billGet an API key, put it in an environment variable without it landing in shell history, send a
curlrequest to the cheapest model, and read the response: the text, the stop reason and the token bill. You needcurl,jqand an account with a card attached or prepaid credit.Claude Messages API, anthropic-version: 2023-06-01 as of 2026-10 · bash 5.2, curl 8, jq 1.7 - newConfigAI · Model APIsA model request, block by block: what goes out every timeA model doesn’t remember past requests: every time it gets everything at once — the system prompt, tool descriptions, the whole conversation and the new question. That’s the context. Here’s a Claude API request block by block: what each field means, what it costs in tokens and what changed in the 5.5 models.Claude Messages API, anthropic-version: 2023-06-01 as of 2026-10 · chat apps build the same kind of request internally
- newTipAI · Model APIsNeed JSON? Give a schema instead of asking “answer in JSON”“Answer in JSON format” sometimes gives JSON wrapped in explanations, with a stray comma or a missing field. Structured output (
output_config.formaton Claude,response_formaton OpenAI) guarantees an answer strictly by a JSON schema: a script parses it without checking “what if there’s text in there”.Claude API — structured output as of 2026-10 · jq 1.7
2026-10-13Tuesday
- newOverviewAI · Language modelsYour own data in a model: context, RAG or fine-tuningA model doesn’t know your documents, configs and notes. There are four ways to give them to it: put them whole into the context, search for the right chunks and feed them in (RAG), let an agent search on its own, or fine-tune the model. The first three work for facts; fine-tuning changes style and format but adds knowledge poorly.Claude Opus 5.5 — documents in context and search in Claude Code
- newCheat sheetAI · Language modelsWhere models fail: the miss, the cause, the fixModel misses repeat, and almost all of them follow from how models work: they continue text plausibly, see tokens instead of letters, know the world up to a cutoff, and are trained to please. By group: what a miss looks like, where it comes from, and what cures it.Claude Opus 5.5 and Sonnet 5.5 · the misses are common to language models — from how models work (Language models)
- newTipAI · Language modelsAsk the documentation, not the model, about its limits, price and versionA model was trained before it was released, so it knows less about itself than about Docker: it can get its window, price, cutoff, capabilities and even its name wrong. Take such facts from the vendor’s page or the API — Anthropic’s
GET /v1/modelsreturns each model’s window and output limit.Claude API GET /v1/models · claude.ai - newTipAI · Language modelsKeep passwords, keys and personal data out of the chatEverything pasted into a chat or read by an agent goes to the provider and stays there: in history, in logs, and on free and consumer plans sometimes in training data. Before pasting a config or a log, replace secrets with
***, and give an agent files without.env.claude.ai, ChatGPT, Gemini — policies from their settings as of 2026-10 · Claude Code — file access rules
2026-10-12Monday
- newOverviewAI · Language modelsLanguage models: how they work, what kinds exist and how they differA language model continues text: from everything in its context it picks the next token, then the next. Knowledge is smeared across the weights rather than stored in a database, so the model writes plausibly, not necessarily correctly. Models differ by tier (price and strength), reasoning, context window, what they accept as input, and where they run — at a provider or on your own hardware.Claude Opus 5.5 and Sonnet 5.5 — claude.ai, Claude Code · prices and windows — Anthropic, OpenAI and Google pricing pages as of 2026-10-18 · tokens — measured with js-tiktoken 1.0.21, o200k_base · open models — from summaries
- newCheat sheetAI · Language modelsModels as of October 2026: families, tiers, prices and windowsAnthropic and OpenAI have converged on one price grid: the strongest model is $10 per million input tokens and $50 per million output, the mid-tier $2 and $10, the small one $0.10 and $0.50. Google is cheaper at the flagship and pricier at the small end. Below: who’s who, what it costs and how much fits in a request. Prices change every few months, so check the vendor’s pricing page before choosing.Anthropic prices — API reference as of 2026-10-06 · OpenAI and Google prices — their pricing pages as of 2026-10-18 · open models — from summaries as of October 2026
- newCheat sheetAI · Language modelsTask and model: which tier and mode for translation, code, logs and documentsFor each typical task: the model tier, whether reasoning is needed, what to put in the context, and where the model most often misses. Tiers follow Models as of October 2026: small (Haiku, Flash-Lite), mid-tier (Sonnet, Flash), flagship (Opus, Pro), the strongest (Fable).Claude Opus 5.5 and Sonnet 5.5 — on this site’s tasks
- newCheat sheetAI · Language modelsGlossary: language model terms in one line eachWords that show up in documentation, price lists and discussions of models — grouped, with a link to the page where the topic is covered in detail.terms — Anthropic, OpenAI, Google, Ollama and llama.cpp as of 2026-10
2026-10-11Sunday
- newTipDesign · Presenting informationOne screen, one ideaWhat’s visible without scrolling answers one question: a page’s first screen — “what is this and what’s it for”, a slide — one conclusion, a dashboard screen — one problem, a chat message — one request. A second idea on the same screen takes attention from the first.from NN/g research (attention and scrolling, 2018) and Lindgaard (first impressions, 2006)
- newCheat sheetDesign · Presenting informationWhat spoils a layout: the sign, why it hurts, what to use insteadA page is more often spoiled by excess: everything highlighted, uniform spacing, gray paler than the threshold, a line across the whole monitor. By group: what the mistake looks like, why it gets in the way of reading, and what to put in its place.WCAG 2.2 — from the standard’s text · NN/g research 1997–2019 — from their articles · contrast computed with the WCAG formula
- newManualDesign · Presenting informationChecking presentation before publishing: six checks in the browserSix checks take about ten minutes and catch most of what spoils a page: the plan by headings, blobs when blurred, a phone at 360 px, dark mode and 200% zoom, contrast, and the five-second test. All of it happens in Chrome or Edge DevTools, with no extensions.Edge 155 (Chromium): console commands and DevTools panels · thresholds — WCAG 2.2
- newTipDesign · Presenting informationCode, commands and output as text, not as a screenshotGive a command, a config or terminal output as a code block, in text: it can be copied, found by search, read on a phone and in dark mode, and edited one line at a time. A screenshot is for when what matters is how an interface looks — and then it’s cropped to the spot that matters.from how browsers and screen readers behave · code blocks — Shiki on this site
- newTipDesign · Presenting informationLink text says where it leads — no “here” or “read more”Link text is what will open: “Traefik labels”, “the October price table”, not “here”, “this” or “read more”. A link is an anchor the eye picks out of a paragraph first, and “here” tells it nothing at that moment.WCAG 2.2, criterion 2.4.4 · per NN/g research (2009) — the first words of links
2026-10-10Saturday
- newConfigDesign · Presenting informationWhite space in CSS: column width, line height and spacing line by lineWhite space is spacing that shows what belongs with what: a line closer to its line, a paragraph to its heading, a group set apart from another group. Here’s the CSS for long-form text line by line: size, line height, column width, spacing around headings, paragraphs and lists, line wrapping.this site’s CSS (`src/styles/prose.css`, `global.css`) · column width and `ch` — measured in Edge 155, Golos 17px, on Russian text · `text-wrap` and `hyphens` support — from MDN
- newTipDesign · TypographyA line is 45–80 characters: limit the column, not the fontA line of long-form text runs from 45 to 75–80 characters, spaces included. Longer, and the eye loses the start of the next line and rereads; shorter, and the rhythm breaks, with lines ending mid-phrase. Set the width on the text column (
max-width) instead of shrinking the font or stretching the page.column width and `ch` — measured in Edge 155, Golos 17px, on this site’s Russian pages · guidelines — Bringhurst, Butterick, WCAG 2.2 - newTipDesign · TypographyText on screen goes left-aligned, not justifiedAlign site text to the left, not to both edges: by default the browser doesn’t hyphenate, so to line up both edges it stretches the spaces — and white “rivers” run through the paragraph. Center only one or two lines: a heading, a caption, a button.WCAG 2.2, criterion 1.4.8 · `text-align: justify` and `hyphens` behaviour — per the CSS specification
- newCheat sheetDesign · ColorText contrast: the WCAG thresholds and the colors that fail themBody text needs 4.5:1 against its background, large text 3:1, and field borders and icons 3:1 as well. Gray
#999on white gives 2.85:1, Tailwind’sgray-4002.54:1: both fail. Below are the thresholds and computed pairs for the most common colors.WCAG 2.2 — from the standard’s text · contrast computed with the WCAG formula (sRGB relative luminance) · Tailwind colors — the version 3 palette
2026-10-09Friday
- newCheat sheetDevelopment · GitUndo in git: what happened — which commandUndoing by situation: an edit in a file, a commit not yet pushed, a commit already on GitHub, and what got lost after a
resetor a rebase. Almost anything committed comes back throughreflog; anything uncommitted afterreset --hardorcleandoesn’t.git 2.55 (Windows) — commands and output run · git 2.43 (Ubuntu 24.04) - newManualDevelopment · GitFind where it broke: log, blame and bisectSomething worked a week ago and doesn’t now.
git log -Sfinds the commit where a line appeared or vanished,git blamewho last changed a line and when, andgit bisecthalves its way to the breaking commit among forty in five or six checks — and can run the checks itself.git 2.55 (Windows) — bisect, log -S and blame run on a practice repository · git 2.43 (Ubuntu 24.04) - newTipDevelopment · GitA secret got into a commit — change the secret first, clean the history secondA password, token or key in a commit stays in history even after the file is deleted. If the commit went to GitHub, treat the secret as leaked: change it first, clean the history second — cleaning doesn’t undo what’s already been downloaded.git 2.55 · git-filter-repo · GitHub push protection
2026-10-08Thursday
- newManualDevelopment · GitBranches in git: merge, rebase and conflicts step by stepA branch per task, work in it, updates from
main, and the way back intomain— by merge or rebase. Which to choose, when, and how to resolve a conflict without losing either your edit or theirs. The main rule of rebase: rewrite only what you haven’t pushed yet.git 2.55 (Windows) — conflicts and output run · git 2.43 (Ubuntu 24.04) - newTipDevelopment · Git.gitignore doesn’t apply to a file already in the repositoryA line in
.gitignorehides only new files. A file that’s already committed is still tracked — edits to it show up ingit status. Remove it from the index withgit rm --cached, and the file stays on disk. But on other copies it gets deleted after apull.git 2.55 (Windows) — output run - newTipDevelopment · Gitpush --force-with-lease instead of --forceAfter a rebase or
--amendof a pushed branch you need a forcedpush.--forceoverwrites the branch on GitHub even if someone else has pushed there meanwhile.--force-with-leaseoverwrites only if GitHub has exactly what you saw at your lastfetch— otherwise it refuses.git 2.55 (Windows) — the `stale info` refusal run
2026-10-07Wednesday
- newCheat sheetDevelopment · GitEveryday git: status, commits, branches, syncingThe commands you need every day, grouped. Undoing and rescuing lost work is separate — Undo in git; finding where it broke — Find where it broke.git 2.55 (Windows) · git 2.43 (Ubuntu 24.04)
- newManualDevelopment · GitGit and SSH keys: deploy keys, two accounts, signed commitsThree jobs handled with SSH keys and aliases in
~/.ssh/config: a server gets access to one repository and nothing else, two GitHub accounts live on one computer, and commits are signed with the same key you log in with — so GitHub marks them “Verified”.git 2.55 and OpenSSH 10.5 (Windows) · git 2.43 (Ubuntu 24.04) · GitHub: deploy keys, SSH signing keys - newTipDevelopment · GitSet line endings in .gitattributes, not core.autocrlfGit for Windows turns LF into CRLF on checkout by default, and a script built on Windows and copied to a server fails:
/bin/bash^M: bad interpreter. The rule* text=auto eol=lfin.gitattributestravels with the repository and works the same on every computer.git 2.55 (Windows), system `core.autocrlf=true` · Ubuntu 24.04 — bash
2026-10-06Tuesday
- newOverviewDevelopment · GitGit: what it is and how it stores historyGit stores a directory’s history as snapshots: every commit is the full state of the files, a link to the previous one, and a note on who and why. A branch is a name pointing at a commit, so branches cost nothing, and almost any action can be undone. A copy on GitHub is the same history, not a separate program.git 2.55 (Windows) — commands and output run · git 2.43 (Ubuntu 24.04)
- newManualDevelopment · GitGit from scratch: the first repository and a push to GitHub over SSHInstall git, introduce yourself to it, create a repository with a
.gitignore, make the first commit and push it to GitHub with an SSH key. Then the daily loop: edit,status,diff, commit,push. You need an SSH key (SSH keys) and a GitHub account.git 2.55 (Windows) — command output run · git 2.43 (Ubuntu 24.04) · GitHub, SSH - newConfigDevelopment · Git~/.gitconfig block by block: what to set onceGlobal git settings: who you are, what to call the first branch, what
pulldoes when branches diverge, how conflicts are shown, and what to do about line endings on Windows. Everything works with git 2.37 and newer — Ubuntu 24.04 ships 2.43.git 2.55 (Windows) — settings and output checked · git 2.43 (Ubuntu 24.04)
2026-10-05Monday
- newTipHomelab · Server changesA disabled stack doesn’t stay on the server “for reference”A stopped stack with a database and keys either goes to an archive off the server or gets deleted. The configs stay in git history anyway.Docker Compose v5.6 · git
- newTipHomelab · Server changesA long instruction gets checks: “expect X, otherwise stop”In a long sequence of commands, put explicit checkpoints: “expect X; if not, stop”.bash
- newTipHomelab · Server changesDependent steps go on one line with &&If step B breaks a service without step A, run them in one line with
&&, in the right order. Then the second step won’t start if the first one failed.bash · git · Docker Compose v5.6 - newTipHomelab · Server changesTest your server’s protection by actionTest protection by doing: ban your own address and see that the site doesn’t open. A config can look right and still not work.CrowdSec 1.6+ in a container
2026-10-04Sunday
- newCheat sheetDesign · Presenting informationChunking text: where to cut and how much goes in one chunkA chunk of text — a paragraph, a bullet, a step, a section — holds one thought, one action or one question. Here: chunk sizes with the reasons, the signs that show where to cut, and the cases where you mustn’t.sizes — rules of thumb with a reason, not measured · lines on a phone — measured in Edge 155, Golos 17px, 360 px wide
- newCheat sheetDesign · Presenting informationVisual anchors: what the eye catches on, and when it stopsAn anchor is whatever differs from plain text and stops the gaze while scanning: a heading, a number, code, a step number, a tag. An anchor works while it’s rare and means the same thing across the page; multiplied, it becomes background.from NN/g research: scanning (2019), numbers in text (2007), banner blindness (1998, 2018)
- newTipDesign · Presenting informationThere are three levels of importance: primary, normal, secondaryA screen can show three distinguishable levels of importance: what’s seen first, the body text, and captions. Each level differs clearly from its neighbour — by size, weight or color; a fourth and fifth level in between can no longer be told apart, and everything blurs into “medium important”.colors and sizes — this site’s CSS (`tokens.css`, `prose.css`) · contrast computed with the WCAG 2.2 formula
- newTipDesign · Presenting informationBold: one or two spots per screenBold works only while it’s rare: when scanning, the eye catches it as a spot on an even background. One or two spots per screen — the things that mustn’t be missed; when half a paragraph is bold, there’s no even background, and the highlighted part disappears.per NN/g’s scanning research (2019)
2026-10-03Saturday
- newManualDesign · Presenting informationScannable text: reworking a wall of paragraphs step by stepText is scannable if it can be understood from the headings and the first words of lines, without reading straight through. Rework a real README paragraph — restoring a database from a backup — step by step, and at the end check the result by reading only the headings.techniques — from NN/g research 1997–2019 · example — the README of a stack with MariaDB
- newTipDesign · Presenting informationA heading says what’s inside: “Where the backups live”, not “General information”A section heading names its point: an answer, an action or the reader’s question. Read in a row, the headings are the page’s plan; if they don’t tell you where things are, “layer cake” scanning won’t work.per NN/g’s scanning research (2019)
- newTipDesign · Presenting informationThe key word at the start of the line: the eye takes the first 11 charactersFrom a list item, a link or a menu line, the scanning eye takes the first two words — about 11 characters. Start the line with the word it’s recognized by, and move “In order to”, “How to” and “Information about” to the end or strike them.per NN/g research (2009)
2026-10-02Friday
- newTipHomelab · Server changesAn edit script with automatic rollbackAn edit script makes a copy, edits, checks, and if the check fails, puts the copy back by itself. Copies go to
/rootand are deleted at the end.bash · Docker Compose v5.6 - newTipHomelab · Server changesAn irreversible command gets a dry run firstBefore an action you can’t undo, see what it will do. git, logrotate, compose and nginx each have their own dry-run mode for that.git · logrotate · Docker Compose v5.6 · nginx
- newTipHomelab · Server changesBefore a fix, look at the line itselfBefore fixing anything, look at the line itself — masked. A search hit, a file name and a comment don’t count as facts.bash
2026-09-29Tuesday
2026-09-28Monday
- newManualHomelab · TraefikTraefik and Let’s Encrypt: wildcard, ACME, a certificate for neighboursRequest wildcard certificates (
*.example.org) on the entry point, not on a router: then they don’t depend on any single service. A wildcard needs the DNS challenge, and the ACME email is written out literally. If someone else needs the certificate, cert-dumper exports it, and the consumer rereads the file on a schedule.Traefik 3.7 · Let’s Encrypt · Cloudflare DNS challenge · traefik-certs-dumper · nginx - newTipHomelab · TraefikMiddleware on a router that doesn’t exist raises no errorCheck the router name in every label. Traefik silently accepts a label with a typo in the name: it creates one more router, and the real one stays unprotected.Docker Compose v5.6 · Traefik 3.7
2026-09-27Sunday
2026-09-26Saturday
- newCheat sheetHomelab · MikroTikEveryday RouterOS: who’s on the network, who’s downloading, updates, backupsRouterOS 7 commands for the Winbox, WebFig or SSH terminal. Menu paths take spaces or slashes:
/ip address printand/ip/address/printare the same. The numbers inprintoutput change, so use[find …]insetandremove.RouterOS 7.24 as of 2026-10-19 - newTipHomelab · MikroTikBack up MikroTik with a text /export; .backup is only for the same router
/exportprints the config as commands: text you can read, compare with the previous version, put in git and paste into another router..backupis a binary snapshot with MAC addresses and passwords, restorable only on the same router. Keep both, but work with the text.RouterOS 7.24 as of 2026-10-19
2026-09-25Friday
- newCheat sheetHomelab · TraefikTraefik labels: router, middleware, serviceThe labels that connect a service to Traefik, and commands to check that Traefik understood them.
memosin the examples is the router and service name; it’s the same in every line of one service.Traefik 3.7 · Docker Compose v5.6 - newTipHomelab · TraefikA router’s middlewares go in one line: a second label overwrites the firstWrite all of a router’s middlewares in one line, comma-separated. Labels are a map: a second line with the same key overwrites the first.Docker Compose v5.6 · Traefik 3.7
- newTipHomelab · Traefiktraefik.yml doesn’t substitute variables
${…}is substituted by compose, and only in the compose file. Traefik readstraefik.ymlitself, so withemail: ${EMAIL_FOR_SSL}the address becomes the string${EMAIL_FOR_SSL}itself — write explicit values in the static config.Docker Compose v5.6 · Traefik 3.7
2026-09-23Wednesday
- newTipHomelab · SecretsA secret goes straight where it belongs, off screenGenerate and move secrets so they never show up in the terminal, in history or in chats: the value lives in a shell variable and goes straight into a file.bash · GNU sed · OpenSSL
- newTipHomelab · SecretsEach key and token grants one accessEach key opens exactly one thing: a deploy key — one repository, a DNS token — the needed zones, a password — one service. Then one leaked key doesn’t open the rest.GitHub deploy keys · Cloudflare API tokens
- newTipHomelab · SecretsShow secrets as structure: paths and names, no valuesFor an inventory, a discussion or a request for help, paths, variable names and the shape of values are enough. Never show the values themselves.bash · GNU sed · awk (mawk/gawk)
2026-09-22Tuesday
- newTipDocker · Docker ComposeThe secret file comes before up -dPut the secret file in place first, then change compose. With
secrets: … file: /srv/secrets/…, compose doesn’t create the container if the file is missing.Docker Compose v5.6 · Traefik 3.7 - newTipHomelab · SecretsKeep passwords out of command argumentsA password in arguments (
-p'password',--password=…,curl -u user:pass) stays in~/.bash_historyand is visible inpsto every user on the server while the command runs.bash · Docker · MariaDB 12.3
2026-09-21Monday
- newConfigDocker · Docker ComposeMariaDB in a container: compose, explainedA compose file for a small database behind one or two sites on a small server: it takes little memory and has none of the settings that trade data safety for speed. Plus a dump and a root password change without the password on the command line.MariaDB 12.3 (mariadb image) · Docker Compose v5.6 · WordPress
- newTipDocker · Docker ComposeThe $ sign: $$ in compose, single quotes in .envIn a compose file, escape
$as$$. In.env, write a single$and wrap the value in single quotes.Docker Compose v5.6 · Traefik 3.7 - newTipDocker · Docker ComposeWhether up -d recreates a service shows in the config hash
up -drecreates a container only if its final config changed.docker compose config --hash '*'before and after an edit tells you in advance.Docker Compose v5.6
2026-09-20Sunday
- newOverviewHomelab · MikroTikWi-Fi on MikroTik: the wifi package, CAPsMAN and roaming — where it’s good and where it falls shortSince RouterOS 7.13 MikroTik’s Wi-Fi lives in the
/interface wifimenu: WPA3, fast 802.11r/k/v roaming, and management of every access point from the router through CAPsMAN. Several cAP ax access points on cable work as one network. The radio on mainstream models is more modest than on consumer flagships: two streams per band, no 160 MHz, Wi-Fi 7 only from 2026.RouterOS 7.24 — from the WiFi page on help.mikrotik.com as of 2026-10-19 · CHR 7.24 — CAPsMAN commands on the router · radio specs — model pages on mikrotik.com - newTipHomelab · MikroTikBefore buying a MikroTik, check the Wi-Fi bands and port speeds in the spec sheetA MikroTik model name says less than it seems: the hAP ax lite and L009UiGS-2HaxD are Wi-Fi 6 but 2.4 GHz only; the hAP ax² has no 2.5G port at all. Before buying, open the model’s page on mikrotik.com and look at two blocks — Wireless and Ethernet.model pages on mikrotik.com as of 2026-10-19
2026-09-19Saturday
2026-09-18Friday
- newTipDocker · Docker Compose.env feeds compose substitution, env_file goes into the containerA
.envnext to compose is for substituting${…}into the compose file itself.env_file: .envalso hands its entire contents to the container, so use it only if the container needs all of those variables.Docker Compose v5.6 · Traefik 3.7 - newTipDocker · Docker ComposeThe stack directory is the compose project name and the volume prefixBefore moving or renaming a stack directory, pin the project name or the volume names. Otherwise compose creates new empty volumes, and the data stays in the old ones.Docker Compose v5.6
- newTipDocker · Docker ComposeUse ./ in volume paths, not $PWDWrite relative volume paths as
./db/. Compose resolves./from the compose file’s directory, while$PWDis the current directory of the shell that ran the command.Docker Compose v5.6
2026-09-17Thursday
- newTipDocker · Docker EngineA missing volume path makes Docker create an empty directoryIf the host path doesn’t exist, the short volume syntax creates an empty root-owned directory in its place. When removing a stack, also remove its paths from neighbours’ volumes — or use the long syntax: in this situation it fails with an error.Docker Compose v5.6
- newTipDocker · Docker EngineA single-file mount doesn’t see your editsIf a single file is mounted into a container (
./nginx.conf:/etc/nginx/nginx.conf), then aftergit pull,sed -iormvthe container keeps seeing the old one. Restart the container after such an edit, and make scripts that update the file write over it, into the same file.Docker · nginx · git - newTipDocker · Docker Enginedocker.sock only for those that can’t do without itAccess to the Docker socket is root on the host. Mount the socket only into services that need it for their job: CrowdSec reads container logs, Traefik reads labels, Promtail reads logs.Docker Compose v5.6
2026-09-16Wednesday
- newManualDocker · Docker EngineDocker on Ubuntu: from Docker’s repository, with a log limitInstall Docker Engine and the Compose plugin from Docker’s repository — not
docker.iofrom Ubuntu and not the snap — and cap container logs right away: with no limit,json-filegrows until the disk is full. The ufw firewall doesn’t close ports that Docker publishes — that’s covered here too.Ubuntu 24.04 LTS · Ubuntu 26.04 LTS — supported by Docker’s repository · Docker Engine 29, Compose v5.6 - newTipDocker · Docker EngineA host-only port goes on 127.0.0.1Publish a port that only the server itself needs on
127.0.0.1.- 8080:8080opens it on every address, and the host firewall’sinputhook doesn’t close it.Docker Compose v5.6 · Ubuntu 24.04
2026-09-15Tuesday
- newManualLinux · SSHSSH tunnels: a closed admin panel through localhostA panel, a database or a dashboard listens only on the server’s
127.0.0.1and isn’t published.ssh -Lopens it on your computer ashttp://127.0.0.1:8080— over the SSH port that’s already open, with no exposed panel login and no new firewall rules.OpenSSH 10.5 on Windows 11 — option parsing · OpenSSH 9.6 server (Ubuntu 24.04) - newManualLinux · FirewallThe ufw firewall: everything closed except SSH and webTurn on ufw with a deny-incoming policy and three open ports: 22, 80 and 443. The order is strict: the SSH rule goes in before
ufw enable. ufw doesn’t close ports that Docker publishes — close those by publishing on127.0.0.1or with the provider’s firewall.ufw 0.36 (Ubuntu 24.04), iptables-nft · Ubuntu 26.04
2026-09-14Monday
- newTipLinux · SSHEditing sshd or the firewall? Keep the old session openBefore you touch
sshd_config,AllowUsers, the port or ufw rules, keep the current SSH session open and test the login from a second window. Close the first only after the second has logged in and runsudo.OpenSSH 9.6 (Ubuntu 24.04) · ufw 0.36 - newTipLinux · SSHMoving off port 22 cuts log noise but doesn’t protect youBots guess passwords on port 22; far fewer show up on another port. That doesn’t protect the server: a scanner finds SSH on any port within minutes. What protects it is key-only login (sshd_config) and banning the guessers (CrowdSec against SSH brute force); move the port if log noise gets in the way.OpenSSH 9.6 (Ubuntu 24.04) · ufw 0.36
2026-09-13Sunday
- newConfigHomelab · MikroTikThe MikroTik default firewall line by line: what each rule doesA home MikroTik’s factory firewall is about fifteen rules, and it already shuts the router and the network off from the internet. It all rests on two interface lists,
LANandWAN, and on rule order: RouterOS goes top to bottom until the first match. Put a new rule in its proper place, not at the end; never delete the last two rules.RouterOS 7.2x, hAP factory config — from exports on the MikroTik forum as of 2026-10-19 · rules checked against the RouterOS 7.24.5 factory script (`/system default-configuration print`) on two other models — identical on both - newTipHomelab · MikroTikallow-remote-requests — the router’s DNS is for your home, not the internet
allow-remote-requests=yesturns the router’s DNS on for the whole network — it’s on in the factory config. Only the firewall closes port 53 from outside. Break the firewall and the router becomes an open DNS resolver: it gets used for amplification DDoS attacks, the CPU sits at 100%, and the ISP sends a complaint.RouterOS 7.24 as of 2026-10-19
2026-09-12Saturday
2026-09-11Friday
- newManualLinux · SSHssh-agent: type the passphrase once per session, and why not ForwardAgentThe agent keeps the decrypted key in memory and signs logins instead of the file: you type the passphrase once, not on every
sshandgit push. Don’t forward the agent to servers — useProxyJumpfor jumps and a deploy key for git on the server.OpenSSH 10.5 on Windows 11, ssh-agent service · macOS and Linux - newCheat sheetLinux · SSHEveryday SSH: logging in, copying, keys, debuggingOpenSSH client and server commands on one screen.
web1is a name from~/.ssh/config(~/.ssh/config); you can write[email protected]instead.OpenSSH 10.5 on Windows 11 — client commands · OpenSSH 9.6 (Ubuntu 24.04) — server commands
2026-09-10Thursday
- newOverviewLinux · SSHSSH: how logging in to a server works and what else it’s forSSH is an encrypted channel to a server on port 22: you use it for a shell, file copies, admin panels that are closed to the outside, and git pushes. Server and user prove who they are with key pairs — and almost every SSH failure comes down to which key sits where.OpenSSH 10.5 client (Windows) — client commands run · OpenSSH 9.6 (Ubuntu 24.04) and 10.2 (Ubuntu 26.04) server
- newTipLinux · SSHCheck the server’s fingerprint before you answer yesOn the first login
sshshows the server key’s fingerprint and asksyes/no. Compare it with what the server itself reports through the provider console — thenknown_hostsremembers the real server, not whoever sits in the middle.OpenSSH 10.5 (client) · OpenSSH 9.6 (Ubuntu 24.04)
2026-09-09Wednesday
2026-09-08Tuesday
2026-09-06Sunday
- newOverviewHomelab · MikroTikMikroTik with no networking experience: what works right away and what you’ll have to learnOut of the box a hAP works like an ordinary router: the ISP’s cable into the first port, the Wi-Fi name and password from the sticker. The difficulty starts when you want to change something: MikroTik shows the network as it is, with no wizard for every case. If you’re willing to spend an evening on it and check for updates once a month, it’s a good router and a networking textbook; if nobody will ever open the settings, it isn’t.the hAP ax² default configuration and Quick Set as of 2026-10-19
- newOverviewHomelab · MikroTikRouterOS 7: how the MikroTik router system worksRouterOS is a Linux-based system, the same for every MikroTik device. Its config is a menu tree that commands change.
/exportprints all of it as one text: that’s both a backup and a way to see what changed. Updates come through thestableandlong-termchannels, optional features install as packages, and since RouterOS 7.17 the dangerous ones sit behind device-mode: they turn on only with a press of a button on the router itself.RouterOS 7.24.5 (stable) and 7.23.8 (long-term) as of 2026-10-19 · CHR 7.24 — the `container` package, device-mode and a container launch (`traefik/whoami` image on the router disk) · device-mode — from the Device-mode page on help.mikrotik.com
2026-09-05Saturday
- newOverviewHomelab · MikroTikMikroTik hardware for home: product lines, internals and which model to buy in 2026For home use MikroTik has five lines: hAP — a router with Wi-Fi, hEX — a router without Wi-Fi, RB5009 — a router for a home lab, cAP and wAP — access points, Chateau — a router with LTE. For an apartment with gigabit internet a hAP ax² is almost always enough; the other models are for 2.5G, several access points, containers or a cabin.specs and tests — model pages on mikrotik.com as of 2026-10-19
- newOverviewHomelab · MikroTikMikroTik at home: what it is, why people like it, and who it suitsMikroTik makes routers, access points and switches, and all of them run one system — RouterOS. A home router gives you everything a carrier router does: bridges, VLANs, routes, chain-based firewall, queues, scripts, containers. The price is time: it works out of the box, but every change after that is yours to make, and you need to know what it changes.RouterOS 7.24.5 (stable) and 7.23.8 (long-term) — from MikroTik’s changelog as of 2026-10-19 · specs — model pages on mikrotik.com as of 2026-10-19
2026-09-04Friday
- newManualLinux · Ubuntu serverFirst login to a server: updates, hostname, a sudo user, key loginThe first 20 minutes of a fresh Ubuntu VPS: update packages, give the server a name and a time zone, create your own user with
sudoand a key, and close password and root logins. You need the server address, the root password or a key from the provider’s panel, and an SSH key on your computer (SSH keys).Ubuntu 24.04 LTS · Ubuntu 26.04 LTS - newTipLinux · Ubuntu serverThe provider console is your fallback — test it before making changesThe web console in the hosting panel connects to the server like a monitor and keyboard — bypassing the network, SSH and the firewall. While it works, a mistake in
sshd_configor ufw takes a minute to fix. Test it before your first change, not after you’ve locked yourself out.VPS with a VNC console in the provider’s panel · Ubuntu 24.04