Gancio

Appearance

Debian installation ​

You will need node.js (>= 20) to install Gancio.

  1. Install Node.js
bash
sudo apt-get install -y curl
sudo curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v

Other node.js installation methods

You can install node.js also using the default debian package or with something like NVM. This last method is recommended if you have multiple node.js services running on your server so you can use different versions of node.js for each service in case of compatibility issues.

  1. Create a user to run gancio from
bash
sudo adduser --group --system --shell /bin/false --home /opt/gancio gancio
  1. Install Gancio
bash
sudo npm global add https://gancio.org/v2/latest.tgz
  1. Setup systemd service and reload systemd
bash
sudo curl https://gancio.org/gancio.service -o /etc/systemd/system/gancio.service
sudo systemctl daemon-reload
sudo systemctl enable gancio
  1. Start gancio service (this should listen on port 13120)
bash
sudo systemctl start gancio

  1. Setup nginx as a proxy

  2. Point your web browser to your domain 🎉

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!