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.

Create accounts with a key and find the instance config

c36d507302c0f7fb24af6eba390c4121d67318c3 · Keenan Nemetz · 16d ago · parent 3abbe749

Create accounts with a key and find the instance config

An account is now written with its first key in one transaction, so a name cannot be claimed without a credential. add-key remains for additional keys, and remote user create forwards the key on stdin.

Local commands now resolve the config from --config, VOLE_CONFIG, ./vole.toml, or ~/.vole/vole.toml before falling back to defaults. init prints --config in its next steps when the instance will not be discovered automatically.

docs/getting-started.md +7−4

@@ -48,17 +48,20 @@ data/audit.log a record of privileged actions
	48	48	```
	49	49
	50	50	`vole admin init` stores an absolute path in `vole.toml`, so you can start Vole from
	51		another directory later.
		51	another directory later. If you initialise into `~/.vole`, commands run from
		52	anywhere find that instance. For another location, pass `--config` or set
		53	`VOLE_CONFIG` (see [Configuration](configuration.md#which-config-vole-reads)).
	52	54
	53	55	## Create an account and a repository
	54	56
	55	57	```sh
	56		vole admin user create you
	57		vole admin user add-key you --key ~/.ssh/id_ed25519.pub
		58	vole admin user create you --key ~/.ssh/id_ed25519.pub
	58	59	vole admin repo create demo --owner you
	59	60	```
	60	61
	61		An account cannot sign in until it has at least one key. The owner of a new
		62	Creating an account requires its first SSH key: the account and key are written
		63	together, so a name is never claimed by an account that cannot sign in. Use
		64	`vole admin user add-key` afterwards to attach more keys. The owner of a new
	62	65	repository is its first admin.
	63	66
	64	67	New repositories are private. To make the web page and anonymous clone URL