Accelerators

Accelerator · Runs on your machine

Fuuz Device Gateway — Docker

One-command Docker deployment for the Fuuz Device Gateway

Get the package All accelerators

Run the Fuuz Device Gateway on any machine with Docker in one command.

Prerequisites

  • A working Fuuz Enterprise environment. The gateway connects to your Fuuz Enterprise tenant. You'll need either:
  • a free limited trial license, or
  • a full Enterprise-scale subscription (public or private cloud).

Don't have one yet? Get started with Fuuz. - Docker Engine with the Compose plugin (docker compose version should print a version). On macOS/Windows, install Docker Desktop. - No registry login or credentials required — the gateway image is pulled anonymously from a public registry.

Quick start

Option A — one-line installer

curl -fsSL https://raw.githubusercontent.com/Fuuz-Platform/device-gateway-docker/main/install.sh | bash

This creates a fuuz-device-gateway/ folder in your current directory, writes the compose file, and starts the gateway.

Option B — clone the repo

git clone https://github.com/Fuuz-Platform/device-gateway-docker.git
cd device-gateway-docker
docker compose up -d

Either way, the gateway is now running in the background.

Check that it's up:

docker compose ps
docker compose logs -f

Updates

You do not upgrade the gateway from the command line. Once it's running and connected to your Fuuz Enterprise tenant, updates are managed from within the running application at runtime — new packages and releases are delivered and applied automatically. There's no need to docker compose pull or re-run the installer to stay current.

Managing the gateway

Task Command
View logs docker compose logs -f
Restart docker compose restart
Stop & remove container docker compose down
Start again docker compose up -d

Run these from the folder that contains docker-compose.yml.

What gets created

The gateway stores its configuration and state in a .gatewaydata/ folder next to docker-compose.yml:

  • .gatewaydata/appData — gateway config, registration, and runtime state
  • .gatewaydata/drivers — custom device drivers

Back up .gatewaydata/ and do not delete it — removing it wipes the gateway's configuration. It is git-ignored so your local state is never committed.

Notes

  • Ports — the gateway publishes host ports 5500–5550. Make sure nothing else on the machine is using that range.
  • Reaching the host — host.docker.internal resolves to the host machine from inside the container, so the gateway can talk to services (OPC-UA, Modbus, the Fuuz platform, etc.) running on the host.

Before you install

A Jump Start, Not A Finished Answer

An accelerator is a pre-built, configurable starting point that addresses the bulk of the common challenges in its domain. It is not intended to solve every possible variation off the shelf — requirements that fall outside it are expected and normal for the model, not a shortcoming of this one.

Standard

Delivered and working as-is. No configuration needed.

Configurable

A base capability you adapt with the platform's own no-code and low-code tools — screen builder, transforms, workflow rules, flow parameters — without professional services.

Custom development

Feasible on the platform but outside this accelerator's current scope. A scoped change through Fuuz or a certified partner.

Once installed, it is yours

Installation forks the flows, models and screens into your environment as your own copies. Later versions published against this accelerator do not propagate to you automatically — picking up a change means deliberately re-applying it.

How accelerators work