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.
update readme and agents
75708127c031e40d026f165ee2de3b5fe219af9c · Keenan Nemetz · 2d ago · parent e73d453f
README.md +21−29
| @@ -1,31 +1,23 @@ | |||
| 1 | 1 | # Vole | |
| 2 | 2 | ||
| 3 | **A forge that lives in your Git repo.** | ||
| 4 | |||
| 5 | Vole keeps a project's work beside its code. Issues, comments, change requests, | ||
| 6 | reviews, and releases are stored in Git, so a clone carries all of it. CI history | ||
| 7 | stays on your own instance. | ||
| 8 | |||
| 9 | ## Why Vole | ||
| 10 | |||
| 11 | - **An outage does not stop you.** Nothing sits in a vendor's database, so a clone | ||
| 12 | with the code is a copy of the work. | ||
| 13 | - **CI runs where you put it.** Start a runner anywhere with Docker, Podman, or | ||
| 14 | nerdctl and Vole sends it work over SSH. A spare desktop is a build machine. | ||
| 15 | - **One binary, one config file.** No database server, no message queue, and no | ||
| 16 | proxy: Vole obtains its own TLS certificates. No cloud account needed. | ||
| 17 | - **Sign in without passwords.** People who file issues enroll a passkey from a | ||
| 18 | one-time link, so there is no password database to protect. | ||
| 19 | - **Small on purpose.** Fewer moving parts, and a codebase you can read end to | ||
| 20 | end. | ||
| 21 | |||
| 22 | Vole is deliberately smaller than GitHub or GitLab. If you need a wide feature | ||
| 23 | matrix or enterprise controls, another forge will serve you better. | ||
| 24 | |||
| 25 | ## Learn more | ||
| 26 | |||
| 27 | - [Documentation](docs/README.md): build it, deploy it, and look up a command. | ||
| 28 | - [Contributing](CONTRIBUTING.md): the issue and change-request workflow. | ||
| 29 | - [Development](DEVELOPMENT.md): tests, the checks CI runs, and using Vole as a | ||
| 30 | Go library. | ||
| 31 | - [License](LICENSE): Apache 2.0. Third-party notices are in [NOTICE](NOTICE). | ||
| 3 | Vole is a free and open-source forge that lives in your Git repo. | ||
| 4 | |||
| 5 | - **Small** Git server, CI runner, and web UI in a single binary. | ||
| 6 | - **Fast** Self-host an instance on a cheap VPS in under 5 minutes. | ||
| 7 | - **Resilient** Issues, changes, reviews, and worklows in your local repo. | ||
| 8 | |||
| 9 | ## Documentation | ||
| 10 | |||
| 11 | Learn more about Vole by reading [docs/README.md](docs/README.md). | ||
| 12 | |||
| 13 | ## Development | ||
| 14 | |||
| 15 | Instructions for development can be found in [DEVELOPMENT.md](DEVELOPMENT.md). | ||
| 16 | |||
| 17 | ## Contributing | ||
| 18 | |||
| 19 | Read [CONTRIBUTING.md](CONTRIBUTING.md) before you contribute. | ||
| 20 | |||
| 21 | ## License | ||
| 22 | |||
| 23 | Vole source code is licensed under [Apache License 2.0](LICENSE). | ||