Link Search Menu Expand Document

Debian installation

  1. Install dependencies
    sudo apt install curl gcc g++ make libpq-dev
  2. Install Node.js & yarn
    curl -sL | sudo bash -
    sudo apt-get install -y nodejs
    sudo npm install -g yarn


  3. Setup with postgreSQL (optional as you can choose sqlite)
    sudo apt-get install postgresql
    # Create the database
    su postgres -c psql
    postgres=# create database gancio;
    postgres=# create user gancio with encrypted password 'gancio';
    postgres=# grant all privileges on database gancio to gancio;
  4. Create a user to run gancio from
    sudo adduser gancio
    su - gancio
  5. Install Gancio
    yarn global add --silent 2> /dev/null
  6. Launch interactive setup
    $(yarn global bin)/gancio setup --config config.json
  7. Start
    $(yarn global bin)/gancio start --config config.json
  8. Point your web browser to http://localhost:13120 or where you selected during setup.

  9. Setup nginx as a proxy

  10. To deploy gancio in production you should use something like pm2:
sudo yarn global add pm2
pm2 start gancio -- --config config.json

# Run this command to run your application as a service and automatically restart after a reboot:
pm2 startup # read the output!
sudo pm2 startup -u gancio


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!

yarn global remove gancio
yarn cache clean
yarn global add --silent  2> /dev/null
sudo service pm2 restart