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.

Add remote administration and local workflow runs

3abbe749096f4d7ff76f4d468e4427829b8a6f95 · Keenan Nemetz · 16d ago · parent 520470e1

Add remote administration and local workflow runs

Make `vole admin` the single namespace for user, repository, and access
management, runnable locally or over SSH by instance admins. Instance-admin
grants live in users.db, and the audit log names the actor separately from the
account being changed.

Add `vole workflow run` to execute workflow jobs in the working tree without a
server or runner. Positional arguments select workflows, --job selects jobs, and
the command reuses the push-time validator.

Update the README and guides for the new command shapes.

docs/getting-started.md +10−7

@@ -30,12 +30,12 @@ go build -o vole github.com/rodent-software/vole/cmd/vole
	30	30
	31	31	## Create an instance
	32	32
	33		Pick a directory for the instance and run `vole init` there:
		33	Pick a directory for the instance and run `vole admin init` there:
	34	34
	35	35	```sh
	36	36	mkdir forge
	37	37	cd forge
	38		/path/to/vole init --dir .
		38	/path/to/vole admin init --dir .
	39	39	```
	40	40
	41	41	Vole creates:
@@ -47,15 +47,15 @@ data/repos/ your Git repositories
	47	47	data/audit.log a record of privileged actions
	48	48	```
	49	49
	50		`vole init` stores an absolute path in `vole.toml`, so you can start Vole from
		50	`vole admin init` stores an absolute path in `vole.toml`, so you can start Vole from
	51	51	another directory later.
	52	52
	53	53	## Create an account and a repository
	54	54
	55	55	```sh
	56		vole user create you
	57		vole user add-key you --key ~/.ssh/id_ed25519.pub
	58		vole repo create demo --owner you
		56	vole admin user create you
		57	vole admin user add-key you --key ~/.ssh/id_ed25519.pub
		58	vole admin repo create demo --owner you
	59	59	```
	60	60
	61	61	An account cannot sign in until it has at least one key. The owner of a new
@@ -65,9 +65,12 @@ New repositories are private. To make the web page and anonymous clone URL
	65	65	readable, publish it:
	66	66
	67	67	```sh
	68		vole acl default demo read
		68	vole admin acl default demo read
	69	69	```
	70	70
		71	Once you have an instance admin, the same commands work from another machine
		72	with `--remote`. See [Users and access](users-and-access.md#remote-administration).
		73
	71	74	## Start Vole
	72	75
	73	76	```sh