| 
				
					
						
							 | 
			||
|---|---|---|
| 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.13 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 
developbranch. - ❗❗❗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.









