BLOCKDOMAINS(5)

📦
version 0.1 · 3 versions
, in ubuntu resolute, ubuntu stonking

💅 BLOCKDOMAINS — block list file format

okay bestie, so this is blockdomains(5) — that's section 5, the file formats section, and it's literally just about how to write a block list file. lowkey the easiest thing ever. let's go 🎀

✨ SYNOPSIS ✨

/etc/blockdomains/acl/blocklist.acl

ln -s ../acl/blocklist.acl /etc/blockdomains/blocked/

that's it. that's the whole vibe. one real file, one lil symlink situation. 🦋

🌸 DESCRIPTION 🌸

so blockdomains reads one or more block list files, and those files contain declarations of the domains you wanna block. one domain per line, okay? and the line has to start with any number of whitespace characters followed by a period (".") before the domain you're blocking. the period is the whole entire point — it's the ✨main character✨ of this file format.

and heads up: the blocking applies to the domain and all its sub domains. so you block one thing, you block the whole family tree. iconic tbh. 👑

anything that does not start with a period (".") is a comment, and any leading whitespace just gets ignored. no notes.

block list domains start with optional whitespace and a period, then the domain name to block, and then optionally a whitespace followed by a comment. like, comment totally optional, you do you. 🫶

🍓 example of a block list

.bad.domain.com -- domain name up to whitespace is blocked

see how the comment just rides along after the whitespace? the domain name goes up to the whitespace and then whatever's after that is vibes only. you're welcome. 💅

blank lines are fine too bestie — they're treated as comments. literally nothing happens, no drama, no error. 🌈

and no, the block list domains don't need to be column aligned. nobody's grading your spacing, this isn't a code review. so here's another one for you:

.another.domain.to.block
End of block list example.

not me giving you two whole examples 😌 periodt.

👀 SEE ALSO 👀

(yeah section 8, the one that actually does the blocking. this page is just the ~format~ ✨)

🎀 AUTHOR 🎀

Ralph Ronnquist rrq@rrq.au — thank u for your service king 🫡💜

omg and that's the whole page!! this was blockdomains(5) from 2026-02-03, served fresh, written by Ralph Ronnquist, and honestly? slay. go write ur block list bestie, u got this 💖🦋✨

📦 where this page comes from