Skip to content

Getting Started

Fluidd requires three components to run:

  • Klipper — the printer firmware
  • Moonraker — the API server that bridges Klipper with web interfaces
  • Fluidd — the web UI you're reading about

The easiest way to install all three is with KIAUH.

KIAUH

KIAUH (Klipper Installation And Update Helper) is the recommended way to install Fluidd. It handles Klipper, Moonraker, and Fluidd installation in one tool, and makes updates simple.

KIAUH also supports installing Kalico as an alternative firmware for advanced users.

View on GitHub

Docker

Fluidd can be hosted with Docker — useful for running a single Fluidd instance that connects to multiple printers.

There are two images available:

  • fluidd — serves on port 80
  • fluidd-unprivileged — serves on port 8080 (for environments requiring unprivileged containers)

Both are updated on each release and each commit. Available tags:

  • latest — most recent release
  • v*.*.* — specific release
  • latest-master / latest-develop — latest commit on that branch
  • sha-<hash> — specific commit

View on GitHub Container registry

Manual Installation

Every Fluidd release includes a pre-built fluidd.zip on the GitHub Releases page. Extract it and serve with any HTTP server (e.g. NGINX).

To build from source (requires Node.js v24.x and Git):

  1. git clone https://github.com/fluidd-core/fluidd.git
  2. cd fluidd
  3. npm ci
  4. npm run build

The output is written to dist/. Note: building on a Raspberry Pi is not supported due to hardware limitations — build on a PC and copy dist/ to your Pi using scp or similar.

fluidd.xyz

Don't want to install Fluidd locally? You can use the hosted version at https://app.fluidd.xyz. Fluidd is downloaded to your browser and communicates directly with your printer on your local network — no data leaves your network unless you configure it to.

To connect, add *://app.fluidd.xyz to the cors_domains section of your moonraker.conf. See the Moonraker example configuration.

FluiddPI

⚠️ WARNING ⚠️

FluiddPI is not under active maintenance and we've had reports from users finding issues while using it.

As such, our recommendation is that you do not use FluiddPI, and instead use KIAUH to install Fluidd.

FluiddPI is a Raspberry Pi OS Lite image pre-configured with Klipper, Moonraker, and Fluidd.

View on GitHub

Download

Download the latest release of FluiddPI.

Flash

  1. Use a quality SD card from a reputable brand (Sandisk, Samsung, Kingston).
  2. The flashing process will wipe your SD card.

For Windows: Balena Etcher. For Linux/macOS: Raspberry Pi Imager.

Configure

  1. Edit fluiddpi-wpa-supplicant.txt on the root of the flashed card to configure Wi-Fi. Do not use WordPad (Windows) or TextEdit (macOS) — use Notepad++, VSCode, or similar.
  2. If you have connectivity issues, try a wired ethernet connection.
  3. Boot the Pi from the card.
  4. SSH into the Pi at fluiddpi.local (or its IP address if Bonjour is unavailable).
  5. Default credentials: pi / raspberry
  6. Run sudo raspi-config to change your password, timezone, locale, and optionally the hostname.
  7. Access Fluidd at http://fluiddpi.local (or http://yourhostname.local if you changed the hostname).