Packaged versions of Gemfast are currently available for ubuntu and debian based systems and rely on systemd for managing the service. Gemfast is also available as a Docker image.

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:


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