Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://gitblit.github.io/gitblit
pure java git solution
https://gitblit.github.io/gitblit
git gitblit
Last synced: 2 months ago
JSON representation
pure java git solution
- Host: GitHub
- URL: https://gitblit.github.io/gitblit
- Owner: gitblit-org
- License: apache-2.0
- Created: 2011-06-22T19:54:49.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2023-10-31T20:23:51.000Z (about 1 year ago)
- Last Synced: 2024-04-16T08:56:47.778Z (8 months ago)
- Topics: git, gitblit
- Language: Java
- Homepage: http://gitblit.com
- Size: 22.5 MB
- Stars: 2,240
- Watchers: 152
- Forks: 667
- Open Issues: 247
-
Metadata Files:
- Readme: README.markdown
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
Gitblit
=================
Gitblit is an open source, pure Java Git solution for managing, viewing, and serving [Git](http://git-scm.com) repositories. It can serve repositories over the GIT, HTTP, and SSH transports; it can authenticate against multiple providers; and it allows you to get up-and-running with an attractive, capable Git server in less than 5 minutes.
More information about Gitblit can be found [here](http://gitblit.com).
License
-------
Gitblit is distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
The text of the license is included in the file LICENSE in the root of the project.
Java Runtime Requirement
------------------------------------
Gitblit requires a Java 8 Runtime Environment (JRE) or a Java 8 Development Kit (JDK).
Getting help
------------
| Source | Location |
| ------------- |--------------------------------------------------------|
| Documentation | [Gitblit website](http://gitblit.com) |
| Forums | [Google Groups](https://groups.google.com/forum/#!forum/gitblit) |
| Twitter | @gitblit or @jamesmoger |
Contributing
------------
GitHub pull requests are preferred. Any contributions must be distributed under the terms of the [Apache Software Foundation license, version 2.0](http://www.apache.org/licenses/LICENSE-2.0).
Please see the [CONTRIBUTING file](CONTRIBUTING.md) for suggestions and guidelines on contributing to Gitblit. Thank you!
### tl;dr
1. [Fork](https://github.com/gitblit-org/gitblit/fork) (and then `git clone https://github.com/gitblit-org/gitblit.git`).
2. Create a branch (`git checkout -b branch_name`).
3. Commit your changes (`git commit -a`).
4. Push to the branch (`git push origin branch_name`).
5. Open a Pull Request.
Building Gitblit
----------------
Gitblit uses submodules.
Make sure to clone using `--recursive` OR to execute `git submodule update --init --recursive`.
[Eclipse](http://eclipse.org) is recommended for development as the project settings are preconfigured.
1. Import the gitblit project into your Eclipse workspace.
*There will be lots of build errors.*
2. Using Ant, execute the `build.xml` script in the project root.
*This will download all necessary build dependencies and will also generate the Keys class for accessing settings.*
3. Select your gitblit project root and **Refresh** the project, this should correct all build problems.
4. Using JUnit, execute the `com.gitblit.tests.GitBlitSuite` test suite.
*This will clone some repositories from the web and run through the unit tests.*
5. Execute the *com.gitblit.GitBlitServer* class to start Gitblit GO.
Building Tips & Tricks
----------------------
1. If you are running Ant from an ANSI-capable console, consider setting the `MX_COLOR` environment variable before executing Ant.
set MX_COLOR=true
2. The build script will honor your Maven proxy settings. If you need to fine-tune this, please review the [settings.moxie](http://gitblit-org.github.io/moxie/settings.html) documentation.