Gogs is a painless self-hosted Git service

Go to file

Unknwon 97772f406d README: remove unstable badge [CI SKIP]		2019-11-02 20:27:03 -07:00
.github	Remove use of develop branch	2019-10-24 18:37:00 -07:00
.packager	packager.io: update scripts (#5837 )	2019-10-24 02:01:43 -07:00
conf	locale: sync from Crowdin	2019-11-02 12:44:15 -07:00
docker	README: use modern style of badges	2019-11-02 20:26:09 -07:00
internal	locale: sync from Crowdin	2019-11-02 12:44:15 -07:00
public	public/css: make less (#5317 )	2018-12-25 08:58:59 -05:00
scripts	scripts/init/ddwrt: removed reliance on sudo, daemonize deals with forking as user. (#5806 )	2019-09-19 15:50:57 -07:00
templates	cmd/import: improve error message	2019-10-26 01:48:19 -07:00
.bra.toml	Makefile: correct errors	2017-07-14 16:48:55 -04:00
.codebeatignore	Add .mailmap	2016-08-11 16:57:48 -07:00
.codebeatsettings	…
.dockerignore	docker: add new Dockerfile.docker-ce for docker-ce(>=v17.06) to build docker image (#5322 )	2018-08-13 20:50:25 +08:00
.editorconfig	milestone: only show issue-related count under issue list (#4316 )	2017-03-24 14:00:01 -04:00
.gitattributes	locale: sync from Crowdin	2018-04-25 13:50:48 -04:00
.gitignore	webhook: minor text change on Discord	2017-02-19 16:07:28 -05:00
.mailmap	Add .mailmap	2016-08-11 16:57:48 -07:00
.pkgr.yml	pkgr: slow but fix builds on packager.io (#5840 )	2019-10-25 21:58:40 -07:00
.travis.yml	Enable Go modules (#5835 )	2019-10-23 23:03:17 -07:00
Dockerfile	dockerfile: add rsync (#5773 )	2019-08-06 19:25:04 -07:00
Dockerfile.aarch64	Dockerfile: always use alpine:latest (#5714 )	2019-08-10 20:23:18 -07:00
Dockerfile.aarch64hub	Dockerfile: always use alpine:latest (#5714 )	2019-08-10 20:23:18 -07:00
Dockerfile.rpi	Dockerfile: always use alpine:latest (#5714 )	2019-08-10 20:23:18 -07:00
Dockerfile.rpihub	Dockerfile: always use alpine:latest (#5714 )	2019-08-10 20:23:18 -07:00
LICENSE	Change LICENSE copyright holder name [CI SKIP]	2016-08-09 13:05:15 -07:00
Makefile	Makefile: set -trimpath on build	2019-10-25 13:16:34 -07:00
README.md	README: remove unstable badge	2019-11-02 20:27:03 -07:00
README_ZH.md	README: use modern style of badges	2019-11-02 20:26:09 -07:00
appveyor.yml	appveyor: remove direct from GOPROXY	2019-10-24 22:53:40 -07:00
go.mod	pkgr: slow but fix builds on packager.io (#5840 )	2019-10-25 21:58:40 -07:00
go.sum	Enable Go modules (#5835 )	2019-10-23 23:03:17 -07:00
gogs.go	cmd/import: improve error message	2019-10-26 01:48:19 -07:00

README.md

Gogs

Current tip version: `.VERSION` (see Releases for binary versions)

Web	UI	Preview

Important Notes

YOU MUST READ Contributing Code BEFORE STARTING TO WORK ON A PULL REQUEST.
Due to testing purpose, data of try.gogs.io was 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 master branch.
If you think there are vulnerabilities in the project, please talk privately to u@gogs.io, and the name you want to be credited as. Thanks!
If you're interested in using APIs, we have experimental support with documentation.
If your team/company is using Gogs and would like to put your logo on our website, contact us by any means.

简体中文

Vision

This project aims to build a simple, stable and extensible self-hosted Git service that can be setup in the most painless way. With Go, this can be done with an independent binary distribution across ALL platforms that Go supports, including Linux, macOS, Windows and ARM.

Overview

Please see the Documentation for common usages and change log.
Want to try it before doing anything else? Do it online!
Having trouble? Get help with Troubleshooting or User Forum.
Want to help with localization? Check out the guide!

Features

Activity timeline
SSH and HTTP/HTTPS protocols
SMTP/LDAP/Reverse proxy authentication
Reverse proxy with sub-path
Account/Organization/Repository management
Add/Remove repository collaborators
Repository/Organization webhooks (including Slack and Discord)
Repository Git hooks/deploy keys
Repository issues, pull requests, wiki and protected branches
Migrate and mirror repository and its wiki
Web editor for repository files and wiki
Jupyter Notebook
Two-factor authentication
Gravatar and Federated avatar with custom source
Mail service
Administration panel
Supports MySQL, PostgreSQL, SQLite3, MSSQL and TiDB (via MySQL protocol)
Multi-language support (30 languages)

Hardware Requirements

A Raspberry Pi or $5 Digital Ocean Droplet is more than enough to get you started. Some even use 64MB RAM Docker CaaS.
2 CPU cores and 512MB RAM would be the baseline for teamwork.
Increase CPU cores when your team size gets significantly larger, memory footprint remains low.

Browser Support

Please see Semantic UI for specific versions of supported browsers.
The smallest resolution officially supported is 1024*768, however the UI may still look right in smaller resolutions, but no promises or fixes.

Installation

Make sure you install the prerequisites first.

There are 6 ways to install Gogs:

Tutorials

Screencasts

How to install Gogs on a Linux Server (DigitalOcean)
Instalando Gogs no Ubuntu (Português)

Deploy to Cloud

Software and Service Support

Drone (CI)
Jenkins (CI)
Fabric8 (DevOps)
Taiga (Project Management)
Puppet (IT)
Kanboard (Project Management)
BearyChat (Team Communication)
HiWork (Team Communication)
GitPitch (Markdown Presentations)

Product Support

Synology (Docker)
One Space (App Store)

Acknowledgments

Thanks Egon Elbre for designing logo.
Thanks Crowdin for sponsoring open source translation plan.
Thanks DigitalOcean, VPSServer, Hosted.nl and MonoVM for sponsoring VPS services.
Thanks KeyCDN for sponsoring CDN service.
Thanks Buildkite for sponsoring open source CI/CD plan.

Contributors

See contributors page for top 100 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.