gogs / gogs

Gogs is a painless self-hosted Git service

简体中文

🔮 Vision

The Gogs (/gɑgz/) project aims to build a simple, stable and extensible self-hosted Git service that can be set up 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-based systems.

📡 Overview

• Please visit our home page for user documentation.
• Please refer to CHANGELOG.md for list of changes in each releases.
• Want to try it before doing anything else? Do it online!
• Having trouble? Help yourself with troubleshooting or ask questions in Discussions.
• Want to help with localization? Check out the localization documentation.
• Ready to get hands dirty? Read our contributing guide.
• Hmm... What about APIs? We have experimental support with documentation.

💌 Features

• User dashboard, user profile and activity timeline.
• Access repositories via SSH, HTTP and HTTPS protocols.
• User, organization and repository management.
• Repository and organization webhooks, including Slack, Discord and Dingtalk.
• Repository Git hooks, deploy keys and Git LFS.
• Repository issues, pull requests, wiki, protected branches and collaboration.
• Migrate and mirror repositories with wiki from other code hosts.
• Web editor for quick editing repository files and wiki.
• Jupyter Notebook and PDF rendering.
• Authentication via SMTP, LDAP, reverse proxy, GitHub.com and GitHub Enterprise with 2FA.
• Customize HTML templates, static files and many others.
• Rich database backend, including PostgreSQL, MySQL, SQLite3 and TiDB.
• Have localization over 31 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:

• Install from binary
• Install from source
• Install from packages
• Ship with Docker
• Try with Vagrant

Deploy to cloud

• Cloudron
• Sandstorm
• sloppy.io
• YunoHost
• DPlatform
• LunaNode
• alwaysdata

Tutorials

• Private Git Web Portal in Raspberry PI With Gogs
• How To Set Up Gogs on Ubuntu 14.04
• Run your own GitHub-like service with the help of Docker
• Dockerized Gogs git server and alpine postgres in 20 minutes or less
• Host Your Own Private GitHub with Gogs
• 使用 Gogs 搭建自己的 Git 服务器 (Chinese)
• 阿里云上 Ubuntu 14.04 64 位安装 Gogs (Chinese)
• Installing Gogs on FreeBSD
• How to install Gogs on a Linux Server (DigitalOcean)

📦 Software, service and product support

• Fabric8 (DevOps)
• Jenkins (CI)
• Puppet (IT)
• Synology (Docker)
• Syncloud (App Store)

🙇‍♂️ Acknowledgments

This project is proundly supported by:

Other acknowledgments:

• Thanks Egon Elbre for designing the original version of the logo.
• Thanks Crowdin for sponsoring open source translation plan.
• Thanks MonoVM for sponsoring VPS services.
• 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.

gogs's Issues

Support deploy to cloud platforms

• Heroku

MD5 is not an appropriate password hashing function anymore

See user.go. The proper approach would be to use a modern KDF such as PBKDF2 or scrypt.

Backwards-compatibility may be maintained by prefixing all new hashes with a string indicating the used scheme such as in "{scrypt}0000SALT0000:0000HASH0000".

v0.2.0 git push error: cannot lock existing info/refs

$ git clone http://10.175.28.105:3000/laofo/collipa.git
$ cd collipa
$ vi README.md
$ git commit -a -m "create by the god"
[master 2ec694f] create by the god
1 file changed, 3 insertions(+), 1 deletion(-)
$ git push origin
error: cannot lock existing info/refs
fatal: git-http-push failed

OS: ubuntu
Gogs version: 0.2.0 Binary install

Register/delete users

• Register users
• Delete users

Multi-language support

Gogs has prepared for i18n feature support in some sense, but we think it's too early to do it without implementing most of main-route features. We may release this feature in v0.5.0.

User management (for Administrators)

Fork/pull request public repostories

• Fork repostories
• Pull request repostories

Allow shorter usernames

When I try to sign up using the username "sqs", I see: "Username must contain at least 5 characters."

GitHub allows one-letter usernames (e.g., https://github.com/q), and I have a 3-letter username on most sites. Would you consider allowing shorter usernames?

Ability to mirror Github repository

Hello,

would be nice if gogs could have ability to mirror/backup existing Github repository.
Including issues and pull requests (and maybe wiki pages).

With option to set how often it should be updated.

Best regards

Update user profile

v0.2.0 no ssh protocol before the server address

Init repository with LICENSE

Create/delete public repostories

• Create public repositories
• Delete public repositories

Organization

Mail notification

is it stable to be deployed in production env?

I mean to deploy in a company. how many company/people use gogs at present?

Is gogs released with BSD license?

Thanks.

git push 501 Not Implemented

When attempting to push for the first time, I receive the following:

[martini] Started GET /matt/test.git/info/refs
[martini] Completed 200 OK in 39.570422ms
[martini] Started GET /matt/test.git/HEAD
[martini] Completed 200 OK in 11.681542ms
[martini] Started PROPFIND /matt/test.git/
[martini] Completed 207  in 11.378867ms
[martini] Started HEAD /matt/test.git/info/refs
[martini] Completed 200 OK in 12.217012ms
[martini] Started HEAD /matt/test.git/objects/info/packs
[martini] Completed 200 OK in 11.366741ms
[martini] Started MKCOL /matt/test.git/info/
[martini] Completed 201 Created in 10.434681ms
[martini] Started LOCK /matt/test.git/info/refs
[martini] Completed 501 Not Implemented in 12.017181ms

Repository viewer

• List directories and file
• Branch list
• Commit list
• View single file
• Auto-render README
• One-click copy for SSH clone URL
• Show latest commit message and commit person

install config 404 error

can't found the config page

why I got "sync database struct error: Default addr for network 'localhost' unknown"

I set the config file
HOST = localhost
USER = root
PASSWD = XXXX

but,I got "sync database struct error: Default addr for network 'localhost' unknown",what is the problem?
Thanks!

Integrate drone

https://github.com/drone/drone

安装页面bug

1.，如果选择sqlite3，因为没有database password而无法提交；
2，如果选择sqlite3，会提示没有import，且此时web server会挂掉；

Repository name contains illegal characters

I'm getting the error "Repository name contains illegal characters" when trying to sign up a user after building and configuring gogs.

Whatever the solution, maybe it should be added to the troubleshooting page.

Add/delete SSH keys

• Add SSH keys
• Delete SSH keys

mysql initialization error

with the package: linux-amd64( gogs.zip)

take an error in initialization database with mysql:
Database setting is not correct: Error 1071: Specified key was too long; max key length is 1000 bytes

mysql version: 5.1.73

LDAP/SMTP/HTTPS protocol support

• LDAP protocol support
• SMTP protocol support
• HTTPS protocol support

Online Markdown Editor

SSH protocols support

• SSH protocol support

v0.2.0 advance options are confusing

The email address has been input in previous page. This page requests it again.

Network graph

Basic idea: git log --graph --oneline.

Wiki

Installation instructions: the first set of commands isn't explicit about the git2go commit ID requirement

I first tried following the first set of instructions at https://github.com/gogits/gogs/wiki/Install-from-source:

# Download main program and dependencies
$ go get -u -d github.com/gogits/gogs

# Install dependencies and build main program
$ cd $GOPATH/src/github.com/gogits/gogs
$ gopm build -v

But I got this error:

$ gopm build -v
gopm INFO Indicated GOPATH: /home/sqs
gopm TRAC Loading gopmfile...
gopm INFO Target name: github.com/gogits/gogs
gopm INFO Linking github.com/gogits/gogs
gopm TRAC Building...
gopm INFO Changing work directory to /home/sqs/src/github.com/gogits/gogs/.vendor/src/github.com/gogits/gogs
gopm INFO Setting GOPATH to /home/sqs/src/github.com/gogits/gogs/.vendor
gopm INFO ===== application outputs start =====

# github.com/libgit2/git2go
38: error: 'git_checkout_options' undeclared (first use in this function)
38: error: 'git_checkout_init_opts' undeclared (first use in this function)
gopm INFO ====== application outputs end ======
gopm INFO Setting GOPATH back to /home/sqs:/home/sqs/.gvm/pkgsets/go1.2/global
gopm INFO Changing work directory back to /home/sqs/src/github.com/gogits/gogs
gopm ERR! build fail to build program:
gopm ERR!   exit status 2

Does the first set of instructions only work for people who have already checked out the 054268 commit of git2go? If so, maybe just remove them altogether.

Not a big issue...I figured it out in like 15-20 seconds, but it might trip other people up.

apache couchdb 1.5.0 is starting as process in my linux system

Dear sir.
i am installed couchdb 1.5.0 . when i started coucdb as couchdb user.. It is running as
user@kumar ~ $ sudo su - couchdb
[sudo] password for kumar:
couchdb@kumar ~ $ couchdb
Apache CouchDB is running as process 1570, time to relax.
couchdb@kumar ~ $
how can i start correctly. please help me to solve.

thanks and regards
kumar

Activity timeline

• Create repository
• Push commits: https://trello.com/c/NvzoYsJP/6-git-push-hook
• Show feed in front-end

mysql port is not 3306,how conf

Message center

Repository/user search (Code and Issues)

• Repositories
• Users
• Issue
• Code

Ship with Docker

Statistics

Issues

没有权限控制，不能建立私有仓库？

如题

Port not included in cloning url

Built from the HEAD yesterday, and the url doesn't seem to include the port, e.g.

should be 'localhost:3000' for me.

Watch

problem start gogs in crontab

Could run /opt/gogs/start.sh as user git successfully in terminal. But failed as cron job.

edit crontab as user git:

# m h  dom mon dow   command
@reboot /opt/gogs/start.sh

After reboot, gogs cannot be started:

From [email protected] Sun Apr 6 18:56:25 2014
Return-Path: [email protected]
X-Original-To: git
Delivered-To: [email protected]
From: [email protected] (Cron Daemon)
To: [email protected]
Subject: Cron git@intense /opt/gogs/start.sh
Content-Type: text/plain; charset=ANSI_X3.4-1968
X-Cron-Env: <SHELL=/bin/sh>
X-Cron-Env: <HOME=/home/git>
X-Cron-Env: <PATH=/usr/bin:/bin>
X-Cron-Env: <LOGNAME=git>
Date: Sun, 6 Apr 2014 18:56:17 +1200 (NZST)
Status: RO

Server is running...
Expect user(git) but current user is:

http://try.gogits.org/forget-password/ 404

点击找回密码时，出现404

GLIBC_2.14 not found

下载：https://gowalker.org/public/gogs_0.2.0_linux_amd64.tar.gz
输入.gogs web
出现：
./gogs: /lib/x86_64-linux-gnu/libc.so.6: version `GLIBC_2.14' not found (required by ./gogs)

Add a "Quickstart" to the README

It would be great if the README had a quickstart: the 4-5 commands you need to run, plus the config you need to change (if necessary...would be great to have a starter config that didn't require changing).

Or a Dockerfile or Vagrantfile.

binary tries to use OS X path on Linux

I'm running Fedora 20 x86_64 as user jschroeder

models.init(fail to create RepoRootPath(/Users/jschroeder/git/gogs-repositories)): mkdir /Users: permission denied

support cznic/ql backend

It would be nice to have a pure-Go backend alternative to sqlite. cznic/ql might fit that role. This depends on ql support by the ORM you are using though.

Users sign in/out

• Users sign in
• Users sign out