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.

Unify account terminology and clarify ACL commands

2e024cc96a391c0959ad2914caeed78b600fcfc1 · Keenan Nemetz · 14d ago · parent ab326d3a

Unify account terminology and clarify ACL commands

Use account consistently in the CLI, help, docs, and remote admin messages. Rename the CLI account command from user to account while retaining the old user spelling as an alias.

Replace positional ACL mutations with explicit verbs such as set-role, protect add, runners remove, and checks enable. Update local and remote admin parsing, hints, docs, and tests.

Tidy repository filter alignment and remove duplicated issue/change counts from page subtitles.

docs/packaging.md +4−4

@@ -38,9 +38,9 @@ and [Configuration § Running behind a proxy](configuration.md#running-behind-a-
	38	38	## First steps after install
	39	39
	40	40	```sh
	41		vole admin --config /etc/vole/vole.toml user create you --key ~/.ssh/id_ed25519.pub
		41	vole admin --config /etc/vole/vole.toml account create you --key ~/.ssh/id_ed25519.pub
	42	42	vole admin --config /etc/vole/vole.toml repo create demo --owner you
	43		vole admin --config /etc/vole/vole.toml acl default demo read
		43	vole admin --config /etc/vole/vole.toml acl set-default-role demo read
	44	44	systemctl enable --now vole
	45	45	```
	46	46
@@ -49,7 +49,7 @@ service account owns the files they write. A command that writes as the wrong us
	49	49	leaves state the service cannot open, so prefer:
	50	50
	51	51	```sh
	52		sudo -u vole vole admin --config /etc/vole/vole.toml user list
		52	sudo -u vole vole admin --config /etc/vole/vole.toml account list
	53	53	```
	54	54
	55	55	## Upgrading
@@ -58,7 +58,7 @@ sudo -u vole vole admin --config /etc/vole/vole.toml user list
	58	58	migration cannot be rolled back. Back up before upgrading:
	59	59
	60	60	```sh
	61		sudo -u vole vole admin --config /etc/vole/vole.toml user backup /var/lib/vole/users.db.bak
		61	sudo -u vole vole admin --config /etc/vole/vole.toml account backup /var/lib/vole/users.db.bak
	62	62	sudo cp /var/lib/vole/data/ssh_host_ed25519_key /var/lib/vole/ssh_host_ed25519_key.bak
	63	63	```
	64	64