vole

Clone

Read only, no credentials:

https://rodent.software/git/vole.git

Write over SSH with a registered key:

git clone ssh://git@0.0.0.0:2222/vole.git

A free and open-source forge that lives in your Git repo.

Rewrite the deployment guides as console walkthroughs

942c93cd06345416c580176c1a149f98e7e96cc0 · Keenan Nemetz · 3d ago · parent 51624dc6

Rewrite the deployment guides as console walkthroughs

With the provider configurations gone, the guides are what is left, and
their shape changed: render a file, paste it into a console field, point a
name at the machine.

The index gains the section the Terraform version did not need — first boot
happens once. Editing the pasted file afterwards changes nothing, which is
how cloud-init works rather than a limitation of these pages, so a later
settings change is editing /etc/vole/vole.toml and restarting, and an
upgrade is a package install.

Each cloud page is a table of console fields: image, size, where the user
data goes, and a firewall. The firewall table is load-bearing rather than
advice, because Hetzner and DigitalOcean leave a new machine open and AWS
hands it a security group that allows nothing inbound.

The runner page leads with render.sh runner and keeps the by-hand path under
it; the registration commands are written out now that no output prints them.

docs/deploy/vps.md +7−6

@@ -1,16 +1,17 @@
	1	1	# Vole on any server
	2	2
	3		The cloud guides each create a machine for you. This page is for the machine you
	4		already have: a VPS from a provider without a Terraform guide, a spare server, or
	5		a virtual machine on your own hardware.
		3	This page is for a provider without its own guide — Vultr, Linode, Scaleway, OVH,
		4	UpCloud, Proxmox — and for the machine you already have: a spare server, or a
		5	virtual machine on your own hardware. The first-boot file is the same one the
		6	[Hetzner](hetzner.md), [DigitalOcean](digitalocean.md), and [AWS](aws.md) guides
		7	paste into their consoles.
	6	8
	7	9	There are two ways, and the first one is less work.
	8	10
	9	11	## A machine that accepts user data
	10	12
	11		Most providers — Vultr, Linode, Scaleway, OVH, UpCloud, Proxmox, and others — let
	12		you paste "user data", "cloud-init", or a "startup script" into the form that
	13		creates a machine. Give it the rendered first-boot file and the machine configures
		13	Most providers let you paste "user data", "cloud-init", or a "startup script" into
		14	the form that creates a machine. Give it the rendered first-boot file and the machine configures
	14	15	itself.
	15	16
	16	17	Render it on your own computer. Pick `ubuntu-24.04` or `debian-13` as the image in