vole

Clone

Read only, no credentials:

https://rodent.software/vole.git

Write over SSH with a registered key:

git clone ssh://git@rodent.software:2222/vole.git

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

Document the root-level URL layout

b7396a1155147a13c5595216f204a545e9f74202 · Keenan Nemetz · 9h ago · parent ed03b3d1

Document the root-level URL layout

The guides now say /<name> for a repository and /-/ for the forge's own pages,
including the clone examples, theme asset paths, profile and registration
URLs, robots.txt, and the deployment package URLs. docs/architecture.md gains
a short URL layout section: why the two spaces cannot collide, the four root
names the forge keeps, and why the transport carries .git.

docs/go-modules.md follows the layout: the module path is the repository page,
the clone URL is the same name with .git, discovery is answered before the
router, and a published module path is durable because renaming the repository
breaks it.

docs/deploy/runner.md +2−2

@@ -18,7 +18,7 @@ of the forge's, no inbound ports except 22, and a disk sized for container image
	18	18	```sh
	19	19	cd deploy/cloud-init
	20	20	FORGE_HOST=forge.example.com \
	21		VOLE_PACKAGE_URL=https://rodent.software/r/vole/releases/v0.2.0/artifacts/vole_0.2.0-1_amd64.deb \
		21	VOLE_PACKAGE_URL=https://rodent.software/vole/releases/v0.2.0/artifacts/vole_0.2.0-1_amd64.deb \
	22	22	./render.sh runner > runner-user-data.yaml
	23	23	```
	24	24
@@ -109,7 +109,7 @@ make every result count whatever the allowlist said.
	109	109
	110	110	## Check that it works
	111	111
	112		- The Admin page's Runners tab (`/admin?tab=runners`) shows what is connected,
		112	- The Admin page's Runners tab (`/-/admin?tab=runners`) shows what is connected,
	113	113	what each runner is building, and how much is queued.
	114	114	- Push a commit on a branch with a workflow. The run page shows which runner took
	115	115	it and whether the result counts.