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.

README.md +7−5

@@ -17,6 +17,8 @@ you do not own.
	17	17	a box in the closet.
	18	18	- It is easy to run. One binary, one config file, and no extra services to
	19	19	operate. You do not need a cloud account to get started.
		20	- Admins can work from anywhere. Instance admins can create users,
		21	repositories, and access rules over the same SSH connection, from any machine.
	20	22	- It is small on purpose. Fewer moving parts, fewer things to break, and a
	21	23	codebase you can read. Vole focuses on the work most teams actually do.
	22	24	- It is open source. The whole thing is yours to read, run, and change.
@@ -32,11 +34,11 @@ forge is probably a better fit.
	32	34	```sh
	33	35	go build -o vole ./cmd/vole
	34	36
	35		./vole init --dir . # create config and data/users.db
	36		./vole user create you
	37		./vole user add-key you --key ~/.ssh/id_ed25519.pub
	38		./vole repo create demo --owner you
	39		./vole acl default demo read # publish: the repo is private until you do this
		37	./vole admin init --dir . # create config and data/users.db
		38	./vole admin user create you
		39	./vole admin user add-key you --key ~/.ssh/id_ed25519.pub
		40	./vole admin repo create demo --owner you
		41	./vole admin acl default demo read # publish: the repo is private until you do this
	40	42	./vole serve # SSH :2222, web :8080
	41	43	```
	42	44