This project is part of the Manorrock Sustainability Initiative. We are seeking new maintainers to take over this project. If no maintainers step forward by December 31, 2025, this repository will be archived and moved to the manorrock-attic organization.

• Through December 31, 2025: Repository remains active while seeking maintainers
• After December 31, 2025: If no maintainers found, project moves to manorrock-attic
• Until December 31, 2030: Project remains available read-only in the attic
• After December 31, 2030: Project may be removed

If you're interested in becoming a maintainer, please see this GitHub issue for details on how to express your interest and what's involved. Note that new maintainers will need to migrate the project to a new namespace, as the Manorrock branding will remain with Manorrock.com.

After December 31, 2025: If this project moves to the manorrock-attic, GitHub issues will no longer be available. If you become interested in maintaining this project after it's archived, please email [email protected] with the subject "Revival Request: [Project Name]".

For more information about the Manorrock Projects Sustainability Initiative, please visit our blog post.

This project delivers an HTTP-based Git repository server.

In an empty directory of your choice, use the following command line to start Manorrock Aegean:

  docker run --rm -d -it -p 8080:8080 -v $PWD:/mnt ghcr.io/manorrock/aegean

To verify the container is up and running, execute the command below:

git clone http://localhost:8080/aegean/repositories/test.git

You should see output similar to the below:

Cloning into 'test'...
warning: You appear to have cloned an empty repository.

Congratulations, you are now running Manorrock Aegean!

To prevent anonymous users from creating new repositories, set the AEGEAN_ADMIN_USERNAME and AEGEAN_ADMIN_PASSWORD environment variables. See the example below:

  docker run --rm -d -it -p 8080:8080 -v $PWD:/mnt -e AEGEAN_ADMIN_USERNAME=admin -e AEGEAN_ADMIN_PASSWORD=adminadmin ghcr.io/manorrock/aegean

If you want to create a new repository, use the -c extraHeader option with the git clone command to provide the admin credentials, as illustrated below:

  git clone -c http.extraHeader="Authorization: Basic $(echo -n 'admin:adminadmin' | base64)" http://localhost:8080/aegean/repositories/test.git

Once you have done this, the repository is created and available for any user to clone.

Yes, you can disable anonymous access to the server by setting the AEGEAN_ANONYMOUS_DISABLED environment variable to true. If you do so, you will also need to provide the admin credentials as described above to interact with the server.

  docker run --rm -d -it -p 8080:8080 -v $PWD:/mnt -e AEGEAN_ANONYMOUS_DISABLED=true ghcr.io/manorrock/aegean

This project will not be developed into a full-blown code hosting platform. It will keep it simple and focus on delivering a Git repository hosting for personal use. If you need more than that, we recommend you look at GitHub, GitLab, Bitbucket, Gitea, GitBucket, or any of the other code hosting platforms available.

The following technologies were used to deliver this project:

1. Eclipse JGit
2. Jakarta CDI
3. Jakarta Servlet
4. Jakarta Security
5. JUnit 5
6. Playwright

See Contributing

See Code of Conduct

Note that if you file issues or answer questions on the issue tracker and/or issue pull requests, you agree that those contributions will be owned by Manorrock.com. Manorrock.com can use those contributions in any manner Manorrock.com desires.