Difficulty: Beginner
Estimated Time: 10 minutes

This course will introduce you to the concepts of OpenFaaS and running your own private functions as a service on Nomad, the environment is pre-configured with Nomad, Consul and OpenFaaS.

If you would like to dive in deeper please take a look at the OpenFaaS documentation at https://github.com/openfaas/faas/blob/master/guide/README.md).

For more information on the Nomad provider, including how to configure monitoring with Prometheus, please see the documentation in our GitHub repo https://github.com/hashicorp/faas-nomad

Nomad OpenFaaS Playground

Step 1 of 4

Getting started

OpenFaaS is a private Functions as a Service (FaaS) platform which you can run on your existing scheduler such as Nomad, Kubernetes, and Docker Swarm. It brings the convenience and efficacy of a function based workflow for developers while providing a very low operational impact.

Useful URLS

Local Docker registry URL


OpenFaaS Gateway



OpenFaaS is built around Docker, all functions are just Docker images which immediately gives a familiar workflow.
The three core components consist of a gateway, a provider, and a monitoring element. The gateway is the external API which allows the administration and execution of functions. It does not directly interact with your scheduler, but delegates this responsibility to a provider which can trigger function deployments and scale functions. Both the gateway and the provider emit metrics such as invocation count and timing data for a function which is collected by Prometheus.

Besides being an excellent way of monitoring your system Prometheus also has the capability of broadcasting alerts based on the stored metrics. This capability allows the gateway to listen for these alerts and react to them. A common example of this is to automatically trigger the scaling of a function based on load.


The OpenFaaS gateway and the Nomad provider has already been deployed to the scheduler, the details of the job can be found at the following link: https://raw.githubusercontent.com/hashicorp/faas-nomad/master/nomad_job_files/faas.hcl

If you run the nomad status command you should see the details of the job.

nomad status faas-nomadd

You should also be able to see the Nomad UI and the OpenFaaS UI by clicking on the tabs at the top of the terminal window.

This tab will not be visible to users and provides only information to help authors when creating content.

Creating Katacoda Scenarios

Thanks for creating Katacoda scenarios. This tab is designed to help you as an author have quick access the information you need when creating scenarios.

Here are some useful links to get you started.

Running Katacoda Workshops

If you are planning to use Katacoda for workshops, please contact [email protected] to arrange capacity.

Debugging Scenarios

Below is the response from any background scripts run or files uploaded. This stream can aid debugging scenarios.

If you still need assistance, please contact [email protected]