Installing Gogs on FreeBSD
March 7, 2015
March 7, 2015
Gogs is a self-hosted Git service, not unlike GitHub, but lightweight and open-source. Here’s a small tutorial to install it in its own jail on a FreeBSD host.
First, create the jail, start it, and open a shell into it. You can skip this step if you don’t want to install it into a jail. Assuming you use ezjail:
ezjail-admin create gogs $ip ezjail-admin start gogs ezjail-admin console gogs Where $ip is the jail IP address.
Then install the required packages:
pkg install go git gcc Add the git user and open a shell with it:
pw useradd git -m su - git And setup the Go environment (locally and permanently):
GOPATH=$HOME/go; export GOPATH echo 'GOPATH=$HOME/go; export GOPATH' >> ~/.profile We can now install Gogs using the Go package manager:
CC=gcc48 go get -u --tags sqlite github.com/gogits/gogs CC=gcc48 is required to force the build tool to use GCC instead of Clang (default on FreeBSD) for the compilation, because it appears some sources fail to be compiled with Clang.
The -u flag tells the Go package manager to use the network to fetch the package and its dependencies.
Here, I choose to use Gogs with SQLite backend, by using --tags sqlite.
I made a symlink to the Gogs directory so I can easily access it:
ln -s go/src/github.com/gogits/gogs gogs Then build Gogs itself (the previous command only fetched it):
cd gogs CC=gcc48 go build --tags sqlite The default configuration can be extended by creating custom/conf/app.ini.
mkdir -p custom/conf vim custom/conf/app.ini We need to at least configure the database, and since we’re on FreeBSD and Bash is not installed by default, we must also tell Gogs to use sh instead (needed for Git hooks), see SCRIPT_TYPE option. Here’s my whole configuration:
RUN_USER = git RUN_MODE = prod [database] DB_TYPE = sqlite3 PATH = data/gogs.db [repository] ROOT = /home/git/gogs-repositories SCRIPT_TYPE = sh [server] DOMAIN = git.codejam.info ROOT_URL = https://git.codejam.info/ HTTP_PORT = 3000 DISABLE_SSH = true LANDING_PAGE = explore [session] PROVIDER = file [log] MODE = file [security] INSTALL_LOCK = true SECRET_KEY = ThisIsNotMySecretKey [service] DISABLE_REGISTRATION = true See the other configuration options and tweak to your tastes!
Run the server with:
./gogs web Ideally you’ll write an init script for this, but I’m lazy and I just put it in a @reboot entry in the crontab:
PATH=/bin:/usr/bin:/usr/local/bin @reboot cd ~/gogs && ./gogs web > logs/main.log To update Gogs to the latest version, basically replay the installation process:
CC=gcc48 go get -u --tags sqlite github.com/gogits/gogs cd ~/gogs CC=gcc48 go build --tags sqlite