87d64acc9f | ||
---|---|---|
cmd | ||
conf | ||
docker | ||
models | ||
modules | ||
packager | ||
public | ||
routers | ||
scripts | ||
templates | ||
.bra.toml | ||
.dockerignore | ||
.editorconfig | ||
.gitignore | ||
.gopmfile | ||
.pkgr.yml | ||
.travis.yml | ||
CONTRIBUTING.md | ||
Dockerfile | ||
LICENSE | ||
README.md | ||
README_ZH.md | ||
config.codekit | ||
docker-compose.yml | ||
gogs.go |
README.md
Gogs - Go Git Service
Current version: 0.6.15 Beta
NOTICES
- Due to testing purpose, data of try.gogs.io has been reset in Jan 28, 2015 and will reset multiple times after. Please do NOT put your important data on the site.
- The demo site try.gogs.io is running under
develop
branch. - ❗❗❗You MUST read CONTRIBUTING.md before you start filing an issue or making a Pull Request, and MUST discuss with us on Gitter for UI changes and feature Pull Requests, otherwise it's high possibilities that we are not going to merge it.❗❗❗
- If you think there are vulnerabilities in the project, please talk privately to u@gogs.io. Thanks!
Other language version
Purpose
The goal of this project is to make the easiest, fastest, and most painless way to set up a self-hosted Git service. With Go, this can be done via an independent binary distribution across ALL platforms that Go supports, including Linux, Mac OS X, and Windows.
Overview
- Please see the Documentation for project design, known issues, and change log.
- See the Trello Board to follow the develop team.
- Want to try it before doing anything else? Do it online or go down to the Installation -> Install from binary section!
- Having trouble? Get help with Troubleshooting.
- Want to help with localization? Check out the guide!
Features
- Activity timeline
- SSH/HTTP(S) protocol support
- SMTP/LDAP/reverse proxy authentication support
- Reverse proxy suburl support
- Account/Organization(with team)/Repository management
- Repository/Organization webhooks(including Slack)
- Repository Git hooks/deploy keys
- Add/remove repository collaborators
- Gravatar and custom source support
- Mail service
- Administration panel
- CI integration: Drone
- Supports MySQL, PostgreSQL, SQLite3 and TiDB
- Multi-language support (14 languages)
System Requirements
- A cheap Raspberry Pi is powerful enough for basic functionality.
- At least 2 CPU cores and 1GB RAM would be the baseline for teamwork.
Browser Support
- Please see Semantic UI for specific versions of supported browsers.
- The official support minimal size is 1024*768, UI may still looks right in smaller size but no promises and fixes.
Installation
Make sure you install the prerequisites first.
There are 5 ways to install Gogs:
Tutorials
- How To Set Up Gogs on Ubuntu 14.04
- Run your own GitHub-like service with the help of Docker
- 阿里云上 Ubuntu 14.04 64 位安装 Gogs (Chinese)
- Installing Gogs on FreeBSD
- Gogs on Raspberry Pi
Screencasts
- Instalando Gogs no Ubuntu (Português)
Deploy to Cloud
Acknowledgments
- Router and middleware mechanism of Macaron.
- Mail Service, modules design is inspired by WeTalk.
- System Monitor Status is inspired by GoBlog.
- Thanks lavachen and Rocker for designing Logo.
- Thanks Crowdin for providing open source translation plan.
Contributors
- Ex-team members @lunny and @fuxiaohei.
- See contributors page for full list of contributors.
- See TRANSLATORS for public list of translators.
License
This project is under the MIT License. See the LICENSE file for the full license text.