On this page

Get Started with SlimFaas

Choose where your functions will run. Each guide opens the same live dashboard and leads into a shared, hands-on tour of functions, queues, events, jobs and data.

  • Get Started with Kubernetes Deploy SlimFaas alongside your workloads. Start here to evaluate Kubernetes operations and a persistent three-node cluster.
  • Get Started in Local Download the complete local demo, or build a Git branch with npm and dotnet. Run real processes without Docker or Kubernetes.
  • Get Started with Docker Compose Run a container-based demonstration with the Docker orchestrator.

Choose your environment

Kubernetes Local Docker Compose
You need A cluster, kubectl, a default StorageClass Bundle and extraction tools, or Git + .NET 10 SDK + Node.js 24/npm Docker Engine and Compose v2, or Podman with Compose
Functions run as Kubernetes workloads Native processes Containers managed through the Docker API
SlimFaas nodes in this demo 3, persistent volumes 3, persistent local directory 1, persistent Docker volumes
Dashboard http://127.0.0.1:30021 with port-forward http://127.0.0.1:30020 http://127.0.0.1:30021
Typical use Cluster evaluation and deployment Application development and debugging Container-based local evaluation

Use one demo at a time: the local cluster's direct node ports overlap with the other demos. The local entrypoint distributes requests among real SlimFaas/Raft nodes; it is not a simulated Kubernetes cluster.

What you will discover

After installation, keep the SlimFaas UI open while following the Guided Tour. Send requests with cURL or the downloadable Bruno collection. Watch functions wake, traffic move through queues, and jobs appear.

The tour includes API responses and cleanup commands. It explains which effects are visible in the dashboard and which must be checked through the API. Find every route, including aliases and internal interfaces, in the API Reference.

Bring your own application

A function is an HTTP application. On Kubernetes, add SlimFaas annotations to its workload; locally, declare its command and health check in a manifest; with Docker, use container labels. See Functions for routing and visibility, Local Mode for manifests and IDE routing, and How It Works for the architecture.

Go further

Explore WebSocket clients, the Kafka connector, and Planet Saver when your application needs them. These integrations have their own prerequisites and are not required for the introductory tour.

Dashboard metadata visibility

The dashboard uses the SlimFaasSite visual theme and provides Overview plus Live Stream → Traffic / Data. Data metadata follows the data API's visibility policy by default. Operators may set SlimFaas__ExposeDataMetadata=true to expose only keys, expiry and file sizes to dashboard visitors while leaving the values private. The native local demo already exposes /data for its tutorial. See the user interface.

The demo configurations also enable SlimFaas__ExposeLogs=true for the dashboard's instance log viewer. Production defaults keep log exposure disabled. Enabling it permits dashboard visitors to read application output as written; see instance logs. Native manifests use cluster.exposeLogs, with an explicit SlimFaas__ExposeLogs environment value taking precedence.

Improve this page on GitHub ↗