🚨 This project is no longer maintained. 🚨
As of March 6, 2025, this repository has been deprecated and will no longer receive updates, bug fixes, or support. If you are interested in self hosting Spin applications, please consider using SpinKube.
The repository will remain available for historical reference.
Thank you to everyone who contributed and used this project!
Fermyon is a platform to host Spin applications and other compatible WebAssembly workloads.
The resources in this repository are intended to provide users with different ways to deploy ("install") Fermyon in their preferred environment.
Fermyon runs on Nomad, so deployment scenarios will first configure and install this software, in tandem with Consul.
Afterwards, the components comprising Fermyon are deployed in the form of Nomad jobs, including a Bindle server, Traefik as the reverse proxy/load balancer and Hippo, the web UI for managing Spin-based applications.
Looking to install Fermyon on your local machine? Follow the local guide to get started.
Once the prerequisites have been installed, this is the quickest and easiest method to launch Fermyon and begin deploying apps.
The AWS single node and AWS multiple node scenarios are great options to go if you'd like to run Fermyon in a separate environment. The former is quicker to launch and uses less cloud resources, while the latter is more robust and enables scaling the cluster size to suit your needs.
This installer utilizes Terraform to deploy a lightweight, working example of Fermyon on AWS, using only a minimal array of resources needed to run the services.
You'll be able to interact with publicly-accessible Bindle and Hippo services
within 5 minutes of invoking terraform apply. From there, you can start
deploying your applications.
The Azure Quick-start is a great option to go if you'd like to run Fermyon in a separate environment.
This installer utilizes Terraform to deploy a lightweight, working example of Fermyon on Azure, using only a minimal array of resources needed to run the services.
You'll be able to interact with publicly-accessible Bindle and Hippo services
within 5 minutes of invoking terraform apply. From there, you can start
deploying your applications.
The GCP Quick-start is a great option to go if you'd like to run Fermyon in a separate environment.
This installer utilizes Terraform to deploy a lightweight, working example of Fermyon on GCP, using only a minimal array of resources needed to run the services.
You'll be able to interact with publicly-accessible Bindle and Hippo services
within 5 minutes of invoking terraform apply -var='project_id=<project_id>'. From there, you can start
deploying your applications.
The DigitalOcean Quick-start is a great option to go if you'd like to run Fermyon in a separate environment.
This installer utilizes Terraform to deploy a lightweight, working example of Fermyon on DigitalOcean, using only a minimal array of resources needed to run the services.
You'll be able to interact with publicly-accessible Bindle and Hippo services
within 5 minutes of invoking terraform apply. From there, you can start
deploying your applications.
The Civo Quick-start is a great option to go if you'd like to run Fermyon in a separate environment.
This installer utilizes Terraform to deploy a lightweight, working example of Fermyon on Civo, using only a minimal array of resources needed to run the services.
You'll be able to interact with publicly-accessible Bindle and Hippo services
within 5 minutes of invoking terraform apply. From there, you can start
deploying your applications.
The Equinix Metal Quick-start is a great option to go if you'd like to run Fermyon on bare metal for better performance or use advanced routing with BGP.
This installer utilizes Terraform to deploy a working example of Fermyon on in multiple metros with a global, anycast, BGP advertised IP on Equinix Metal.
You'll be able to interact with publicly-accessible Bindle and Hippo services
within 5 minutes of invoking terraform apply. From there, you can start
deploying your applications.
The Hetzner Quick-start is a great option to go if you'd like to run Fermyon in a separate environment.
This installer utilizes Terraform to deploy a lightweight, working example of Fermyon on Hetzner, using only a minimal array of resources needed to run the services.
You'll be able to interact with publicly-accessible Bindle and Hippo services
within 5 minutes of invoking terraform apply. From there, you can start
deploying your applications.
After installing Fermyon in your preferred environment, you are ready to deploy your first application.
Follow the deploy guide to get started.
