Packaged versions of Gemfast are currently available for ubuntu and debian based systems and rely on systemd for managing the service.

Install Gemfast on Debian/Ubuntu

To install Gemfast, download a .deb package from


And then install it using dpkg:

sudo dpkg -i ./gemfast-latest-x86_64.deb

If using an arm64 architecture make sure to download gemfast-latest-arm64.deb instead.

The main configuration file is 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:


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

Basic Setup