Fork of GoGS with fulltext commit search support
 
 
 
 
 
 
Go to file
David Beitey cf7d5d0c56 docker: fix heading in README.md (#4353)
The unicode non-breaking space character was breaking the heading format; this switches that character for an ASCII space.
2017-03-28 07:50:36 -04:00
.github mailer: make text/html as default format 2017-02-27 22:46:42 -05:00
cmd cmd/web: remove dependency version checker 2017-03-25 04:17:55 -04:00
conf Update locales 2017-03-27 14:40:55 -04:00
docker docker: fix heading in README.md (#4353) 2017-03-28 07:50:36 -04:00
models models/protect_branch: fix whitelist with invalid 'protect_branch_id' (#4333) 2017-03-27 13:13:04 -04:00
modules Update locales 2017-03-27 14:40:55 -04:00
packager packager: update files (#4181) 2017-02-23 15:33:58 -05:00
public repo: allow private repository to have public wiki or issues 2017-03-24 16:25:40 -04:00
routers repo/settings/branches: add prompt for bare repository 2017-03-27 13:12:29 -04:00
scripts scripts: update gogs.service (#4223) 2017-03-04 11:40:37 -05:00
templates Prepare release 2017-03-27 14:56:56 -04:00
vendor models: add config options for XORM logger (#3183) 2017-03-23 18:34:25 -04:00
.bra.toml models/repo_editor: improve code quality 2016-08-15 22:20:55 -07:00
.codebeatignore Add .mailmap 2016-08-11 16:57:48 -07:00
.codebeatsettings Adjust .codebeatsettings 2016-08-08 23:26:10 -07:00
.dockerignore docker: use vendor to replace go get 2017-03-27 14:04:48 -04:00
.editorconfig milestone: only show issue-related count under issue list (#4316) 2017-03-24 14:00:01 -04:00
.gitattributes public: minor fixes on build tool config 2017-03-06 17:59:36 -05:00
.gitignore webhook: minor text change on Discord 2017-02-19 16:07:28 -05:00
.gopmfile Prepare release 2017-02-27 18:38:16 -05:00
.mailmap Add .mailmap 2016-08-11 16:57:48 -07:00
.pkgr.yml packager: update files (#4181) 2017-02-23 15:33:58 -05:00
.travis.yml Add Go 1.8 to .travis.yml 2017-03-16 17:46:55 -04:00
Dockerfile Provide an updated Dockerfile where Gogs is build with Go 1.8 (#4151) 2017-02-18 20:43:27 -05:00
Dockerfile.aarch64 adapt Dockerfile.aarch64 (#4210) 2017-02-28 16:16:23 -05:00
Dockerfile.rpi docker: update Dockerfile for Raspberry Pi (#4185) 2017-02-24 00:37:21 -05:00
LICENSE Change LICENSE copyright holder name [CI SKIP] 2016-08-09 13:05:15 -07:00
Makefile wiki: fix crash with blob name contains tab (#3916) 2017-02-16 11:47:54 -05:00
README.md README: update alts 2017-03-22 15:28:22 -04:00
README_ZH.md Update README 2017-02-25 21:21:12 -05:00
appveyor.yml Update CI settings 2017-02-09 20:11:34 -05:00
gogs.go Prepare release 2017-03-27 14:56:56 -04:00

README.md

Gogs Build Status Build status Crowdin Sourcegraph Gitter

Current tip version: .VERSION (see Releases for binary versions)
Web UI Preview
Dashboard Repository Editor
Profile Diff Repository Settings
Webhook Organization Admin Dashboard

Important Notes

  1. YOU MUST READ Contributing Code BEFORE STARTING TO WORK ON A PULL REQUEST.
  2. 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.
  3. The demo site try.gogs.io is running under develop branch.
  4. 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!
  5. If you're interested in using APIs, we have experimental support with documentation.
  6. If your team/company is using Gogs and would like to put your logo on our website, contact us by any means.

简体中文

Purpose

The goal of this project is to make the easiest, fastest, and most painless way of setting up a self-hosted Git service. With Go, this can be done with an independent binary distribution across ALL platforms that Go supports, including Linux, Mac OS X, Windows and ARM.

Overview

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
  • Gravatar and Federated avatar with custom source
  • Mail service
  • Administration panel
  • Supports MySQL, PostgreSQL, SQLite3, MSSQL and TiDB (experimental)
  • Multi-language support (23 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 5 ways to install Gogs:

Tutorials

Screencasts

Deploy to Cloud

Software and Service Support

Product Support

Acknowledgments

  • Thanks Egon Elbre for designing logo.
  • Thanks Crowdin for providing open source translation plan.
  • Thanks DigitalOcean for hosting home and demo sites.
  • Thanks KeyCDN and QiNiu for providing CDN service.

Contributors

License

This project is under the MIT License. See the LICENSE file for the full license text.