A gitweb/cgit-like interface for the modern age. Written in Rust using Axum, git2, Askama and RocksDB.
Includes a dark mode for late night committing.
-
Efficient Metadata Storage
RocksDB is used to store all metadata about a repository, including commits, branches, and tags. Metadata is reindexed, and the reindex interval is configurable (default: every 5 minutes), resulting in up to 97% faster load times for large repositories. -
On-Demand Loading
Files, trees, and diffs are loaded using git2 directly upon request. A small in-memory cache is included for rendered READMEs and diffs, enhancing performance. -
Dark Mode Support
Enjoy a dark mode for late-night committing, providing a visually comfortable experience during extended coding sessions.
Before you begin, ensure that you have the Rust toolchain and Cargo installed. If you haven't installed them yet, you can do so by following the instructions provided on the official Rust website:
Once you have Rust and Cargo installed, you can proceed with setting up and running the project.
Note: This software is designed to work exclusively with bare Git repositories. Make sure to set up bare repositories beforehand by following the Git on the Server documentation.
cargo install --git https://github.com/w4/rgit
Clone the repository and build:
git clone https://github.com/w4/rgit.git
cd rgit
cargo build --release
The rgit binary will be found in the target/release
directory.
To get up and running quickly, run rgit with the following:
rgit [::]:3333 /path/to/my-bare-repos -d /tmp/rgit-cache.db
Notes:
- Repository indexing is recursive.
- The database is quick to generate, so this can be pointed to temporary storage.
To set a repository description, edit the file named description
inside the bare git repository. Add your desired description text to this file.
To assign an owner to a repository, edit the file named config
inside the bare git repository and include the following content:
[gitweb]
owner = "Al Gorithm"
Replace Al Gorithm
with the desired owner's name.
Running rgit on NixOS is straightforward, simply import the module into your flake.nix
and use the provided service:
{
inputs = {
nixpkgs.url = "github:NixOS/nixpkgs/nixos-23.05";
rgit = {
url = "github:w4/rgit";
inputs.nixpkgs = "nixpkgs";
};
};
outputs = { nixpkgs, ... }: {
nixosConfigurations.mySystem = nixpkgs.lib.nixosSystem {
modules = [
rgit.nixosModules.default
{
services.rgit = {
enable = true;
bindAddress = "[::]:3333";
dbStorePath = "/tmp/rgit.db";
repositoryStorePath = "/path/to/my-bare-repos";
};
}
...
];
};
};
}
Running rgit in Docker is straightforward. Follow these steps, ensuring that your repository directory is correctly mounted:
docker run --mount type=bind,source=/path/to/my-bare-repos,target=/git \
--user $UID:$GID \
-it ghcr.io/w4/rgit:main
Note: Replace $UID
and $GID
with the UID and GID of the user that owns the directory containing your repositories. If these values are incorrect, errors will occur. Learn how to find the UID of a user here.
An example docker-compose.yml
is provided for those who prefer using Compose. To configure
the UID and GID, the user can be specified in docker-compose.override.yml
.
An example override file has been has been provided with the repository. To use it, remove the
.example
extension from docker-compose.override.yml.example
, and adjust the UID and GID to
match the user that owns the directory containing your repositories.
To configure automatic refresh in Docker, an environment variable is also provided.
services:
rgit:
environment:
- REFRESH_INTERVAL=5m
Afterwards, bring up the container with docker-compose up
to make sure everything works.
Pull requests are welcome via GitHub or git-send-email
.
rgit is licensed under the WTFPL.
Symptom: When attempting to clone repositories via HTTPS, you encounter the error message:
Git returned an error: Repository not exported
Solution:
Create a file named git-daemon-export-ok
in the bare git repository. This file signals to the git daemon that the repository is exportable.
Symptom: When launching the application, you receive the error message:
repository path '/git/path/to/my/repository.git/' is not owned by the current user
Solution:
Ensure that the user launching rgit
or the Docker container has the same permissions as the user that owns the repositories directory.
Symptom: When using the application, a newly initialized bare repository without commits does not appear in the list.
Solution: Run the following command inside the repository to initialize it:
git pack-refs --all
Alternatively, push a commit with at least one file to the repository. This will also make the repository appear in the list.