Aegis

A web frontend for Git.

Build

Requires Go v1.24+

make all

Installation

Run the following command:

./aegis -init

And choose to start the web installer. It will guide you through the configuration process.

After the configuration process, run:

./aegis -config {config_file_path}

This would set up everything that’s required. After the setup process is completed, run the same command again to start the “main” web server.

This process would show you the password for the admin user, which is randomly generated. You can override this password by running:

./aegis -config {config_file_path} reset-admin

Currently Aegis only supports the following systems for its components; support for other systems are planned:

• Main database:
  • SQLite3
• Receipt system (see ./docs/receipt.org):
  • SQLite3
• Session store:
  • SQLite
  • Redis & Redis-like (ValKey, KeyDB)
  • Memcached
• Mailer:
  • GMail (through App Password)