Link Search Menu Expand Document

Docker installation

  1. Initial setup
  2. Use sqlite
  3. Use postgreSQL
  4. Start gancio
  5. Upgrade

Initial setup

  • You must have the following dependencies installed: Docker, Docker Compose and Nginx
sudo apt install docker docker-compose nginx

or

  1. Install docker
  2. Install docker-compose
  3. Install nginx
  • Create a directory where everything related to gancio is stored
    mkdir -p /opt/gancio
    cd /opt/gancio
    

Use sqlite

  1. Download docker-compose.yml and Dockerfile
    wget https://gancio.org/docker/Dockerfile
    wget https://gancio.org/docker/entrypoint.sh
    wget https://gancio.org/docker/sqlite/docker-compose.yml
    
  2. Build docker image
    docker-compose build
    

Use postgreSQL

  1. Download docker-compose.yml and Dockerfile
    wget https://gancio.org/docker/Dockerfile
    wget https://gancio.org/docker/entrypoint.sh
    wget https://gancio.org/docker/postgres/docker-compose.yml
    
  2. Build docker image
    docker-compose build
    

Start gancio

  1. Run your container
    docker-compose up -d
    
  2. Look at logs
    tail -f  data/logs/gancio.log
    
  3. Setup nginx as a proxy

  4. Point your web browser to your domain :tada:

  5. Edit data/config.json and restart the container on your needs, see Configuration for more details.

Upgrade

Backup your data

Backup your data is generally a good thing to do and this is especially true before upgrading. Don’t be lazy and backup your data!

Upgrade from a version < 1.0

Since v1.0 our docker setup is changed and a new container has to be built:

  1. cd /opt/gancio
  2. Backup your data
  3. Download new Dockerfile
    wget https://gancio.org/docker/Dockerfile
  4. Download new entrypoint.sh
    wget https://gancio.org/docker/entrypoint.sh
  5. Download new docker-compose.yml (substitute sqlite with postgres in case):
    wget https://gancio.org/docker/sqlite/docker-compose.yml
  6. Build the new container docker-compose build
  7. Extract your backup into ./data
    mkdir data; tar xvzf gancio-<yourLastBackup>-backup.tgz -C data
  8. Stop your old container docker-compose stop
  9. Start your new container docker-compose up
cd /opt/gancio
docker-compose up -d --no-deps --build