Installation

The easiest way to run gitseeker is docker, more ways might be available in the future

Prerequisites

• A PostgreSQL database
• Enough storage space for your git repositories

Docker

codingkiwi/gitseeker

Using docker-compose

Create a docker-compose.yaml file with the following content (or add the gitseeker service to your existing file):

version: '3.1'

services:
  db:
    image: postgres
    restart: unless-stopped
    environment:
      POSTGRES_USER: gitseeker
      POSTGRES_PASSWORD: secret
      PGDATA: '/var/lib/postgresql/data/pgdata'
    volumes:
      #- "/host/path/data/db:/var/lib/postgresql/data"

  gitseeker:
    image: codingkiwi/gitseeker:1
    user: 1000:1000 # should be owner of volumes
    restart: unless-stopped
    environment:
      PGHOST: db
      PGUSER: gitseeker
      PGDATABASE: gitseeker
      PGPASSWORD: secret
      APP_SECRET: secret
      ADMIN_USER: admin
      ADMIN_PASS: admin
    ports:
      - 8080:8080
    volumes:
      #- "/host/path/data/repos:/data/repos"
      #- "/host/path/data/logs:/data/logs"

After that you can start your containers with docker-compose up -d

TIP

Repositories will be cloned into the /data/repos inside the container, you should mount the directory to some path on the host machine so the repositories don't have to be cloned again if the container is destroyed.

TIP

Log files will be created in /data/logs inside the container

Using docker

docker run -d \
  --name=gitseeker \
  --restart=unless-stopped \
  --user $(id -u):$(id -g) \
  -v /host/path/data/repos:/data/repos \
  -p 8080:8080
  -e PGHOST=db \
  -e PGUSER=gitseeker \
  -e PGDATABASE=gitseeker \
  -e PGPASSWORD=secret \
  -e APP_SECRET=secret \
  -e ADMIN_USER=admin \
  -e ADMIN_PASS=admin \
  codingkiwi/gitseeker:1

Customization

• The user argument should ideally reflect the UID:GID of the owner of the music library to avoid permission issues. For testing purpose you could omit this directive, but as a rule of thumb you should not run a production container as root.
• Environment Variables - see Configuration