Runfold turns a technical guide into a page that knows your setup: your values in every command, only the steps for your stack, and exactly as much explanation as you ask for.
YOUR_SERVER_IP into a terminal.One script does the whole page, with your values. Download it, read it, run it.
Let the firewall accept the new port before restarting SSH.
The order matters. If SSH moves to port before the firewall lets that port in, the restart cuts the session you are typing in, and the next login times out.
ufwfirewalld accepts packets of connections that are already open before it looks at port rules, which is why this session survives. A new port does not make SSH stronger; it makes the logs readable by removing almost every automated attempt.
A guide, the way you would read it.
Runfold does not add a chatbot on top of the same old page. It changes what a page is: written once, in layers, with the reader's context declared.
The usual guide
ssh <user>@YOUR_SERVER_IP -p PORT # don't forget to change these!
On Runfold
$ ssh ops@203.0.113.10 -p 1234
You fill a field once for the whole series. Every command on every page uses it, and a block will not copy while a value it needs is empty or invalid.
The usual guide
On Debian/Ubuntu, see 4.2. On RHEL/Rocky, skip to 4.5, unless you use Apache (see appendix B).
On Runfold
Your stack: Debian · Caddy · Let's Encrypt → the steps for that, nothing else
Choices shape the page: the outline, the commands, the diagram and the downloadable script all follow them.
The usual guide
sudo systemctl restart ssh # (no explanation) …or forty paragraphs before the first command.
On Runfold
Run one script Quick the commands, one line each Guided why each step, and how Deep the mechanism and the traps
The same page serves the person who did it last week and the person doing it for the first time.
Too lazy to read? Run the script. It worked? Read Quick to see what it did. Didn't get it? Read Guided. Want to understand everything? Read Deep.
Automatique
One script that does the whole page, filled with your values.
You trust it and want it done.
Express
The commands, and one line each.
You have done this before.
Détaillé
Why each step, and how to tell it worked.
It is your first time.
Exhaustif
The mechanism, the alternatives, the traps.
You want to own it.
Every page opens with the gist as a live drawing. Simple at Quick, every layer (DNS, TLS, ports, units) at Deep. Hover a box to read what it does; open it full screen.
Each block says whether it runs on your laptop or the server, and as which user. A file is shown once, whole, and copies as a ready command.
After each step, a command and its expected output. Progress is kept per page and per series.
Every step has a link that opens an issue already filled with the page, the step, your level and your stack. Never your values.
A link and a QR code bring your values, choices and progress to your other laptop or a colleague. It lives in the URL fragment: no server sees it, and secrets never travel.
Search across every page with /, print exactly what you read, and pick a look, from editorial serif to a 2001 media player.
Switching depth, typing a hostname that rewrites every command, changing the web server, the diagram in full screen, the share link and its QR code.
A page is a folder: the variables and choices in YAML, the prose in MDX, one file per language, and a small diagram.
${SSH_PORT} in a command becomes the reader's value.<Guided> and <Deep> hold the layers; <When> follows the stack.AUTHORING.md is a self-contained brief: give it to a person or a model with a subject, get a page back.## Open the new port, then move SSH ```bash on="server" as="${USERNAME}" sudo ufw allow ${SSH_PORT}/tcp sudo systemctl restart ssh ``` <Guided>The firewall must accept <V name="SSH_PORT" /> before SSH moves to it.</Guided> <Deep>Why the open session survives: …</Deep> <Check cmd="ssh -p ${SSH_PORT} ${USERNAME}@${SERVER_IP} echo ok" expect="ok" />
Runfold is a static site: build it, put it on any web server, and your team reads it without an account. It is in preview; every page in the demo is a draft until its author has run it end to end.