Debian installation

1. Install dependencies

   sudo apt install curl gcc g++ make libpq-dev
   

2. Install Node.js & yarn

   curl -sL https://deb.nodesource.com/setup_16.x | sudo bash -
   sudo apt-get install -y nodejs
   sudo npm install -g yarn
   

   source

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 https://gancio.org/latest.tgz 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

Upgrade

yarn global remove gancio
yarn cache clean
yarn global add --silent https://gancio.org/latest.tgz  2> /dev/null
sudo service pm2 restart