Self-Hosted Server

Covergates provides the easiest way to run self-hosted service!

Getting Start

Get latest released covergates-server binary. Download .tar.gz for your platform and extract it to the path you like. Then run:


./covergates-server

The server should start and bind to http://localhost:8080.

Configuration

covergates-server uses environment variables to config.

Config Server

You can config server address and it’s base url.

GATES_SERVER_ADDR Default http://localhost:8080
GATES_SERVER_BASE Default /

For example:


export GATES_SERVER_ADDR="https://covergates.com"


export GATES_SERVER_ADDR="http://your.domain.name"
export GATES_SERVER_BASE="/covergates"

# Server will bind to http://your.domain.name/covergates

Config Database

covergates-server uses SQLite by default, therefore database server is not necessary. It will create a core.db under working path, all reports will save into core.db. You can change the database name with:


export GATES_DB_NAME="covergates.db"

To use PostgreSQL as database server. Here is an example:


export GATES_DB_DRIVER="postgres",
export GATES_DB_HOST="127.0.0.1",
export GATES_DB_PORT="5432",
export GATES_DB_USER="postgres",
export GATES_DB_NAME="covergates",
export GATES_DB_PASSWORD="PASSWORD",

You need to create a database on your PostgreSQL server in advance.

To use MySQL as database server. Here is an example:


export GATES_DB_DRIVER="mysql",
export GATES_DB_HOST="127.0.0.1",
export GATES_DB_PORT="3306",
export GATES_DB_USER="mysql",
export GATES_DB_NAME="covergates",
export GATES_DB_PASSWORD="PASSWORD",

Do not use NO_ZERO_IN_DATE in your sql_mode. Covergates may use dummy date (value Zero) for OAuth token without expiration date

Config Git Service

covergates-server requires to connect with a Git service to access your source code. Supported Git service are:

Please refer to the Git service you using to learn how to config covergates-server.