Gemfast is distributed as both a .deb package and a Docker image. It is recommended to use the .deb package when installing Gemfast on a virtual machine or bare metal server.
Install Gemfast on Debian/Ubuntu
To install Gemfast, download the latest Debian installer from GitHhub.
And then install it using dpkg:
sudo dpkg -i ./gemfast_<version>_amd64.deb
Once installed the main configuration file can found at /etc/gemfast/gemfast.hcl.
Managing the Gemfast Service
Gemfast is managed using the systemd init system. Gemfast consists of a web server service /etc/systemd/system/caddy.service and the Gemfast server service /etc/systemd/system/gemfast.service. These two services are dependant on each other executing a systemctl start/stop/restart on one, causes the other to do the same action.
To start the server and enable the server, run:
sudo systemctl enable gemfast.service --now
To restart the server, run:
sudo systemctl restart gemfast.service
To stop the server, run”
sudo systemctl stop gemfast.service
Upgrade Gemfast on Debian/Ubuntu
To upgrade Gemfast, download a newer version:
wget https://downloads.gemfast.io/stable/latest/gemfast-latest-x86_64.deb
And then install it using dpkg:
sudo dpkg -i ./gemfast-latest-x86_64.deb
This will install the newer version of Gemfast, removing the older version in the process.
Uninstall Gemfast on Debian/Ubuntu
To uninstall Gemfast, run the following command:
sudo dpkg -r gemfast