Sign in

Search issue titles and bodies, change requests and comments. Private repositories you cannot read are not included.

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).