Documentation
TutorialsCommunity
  1. ALPON
  2. Tutorials

Deploying FUXA

Deploy FUXA as a container on ALPON X5 AI or ALPON X4 through ALPON Cloud: pull the image, push it to the Sixfab Container Registry (or use Docker Hub), map port 31881 and four persistent volumes, and open the FUXA editor.

Deploy FUXA on ALPON

Run FUXA as a container on your ALPON X5 AI or ALPON X4 and build web-based SCADA/HMI dashboards that monitor and control the devices on your local network. This guide deploys the official image through ALPON Cloud, mounts four persistent data directories, and opens the FUXA editor on port 31881.

ALPON X5 AI ALPON X4 FUXA SCADA / HMI
ALPON · Tutorial · Containers · Industrial automation
How do I deploy FUXA on ALPON?

Push the frangoteam/fuxa image to your Sixfab Container Registry (or deploy it straight from Docker Hub), then use the Applications → Deploy panel on ALPON Cloud to launch the container on your ALPON X5 AI or ALPON X4 with port 31881 → 1881 and four /tmp/fuxa_* volumes. Open http://<DEVICE_IP>:31881 in a browser to reach the FUXA dashboard.

Overview

FUXA is a free, open-source web-based process visualization platform (SCADA / HMI / dashboard) for monitoring and controlling industrial and IoT devices over protocols such as Modbus, OPC UA, and MQTT. Running it as a container on an ALPON X5 AI or ALPON X4 keeps the visualization local: the device sits on the same network as your equipment, works without a cloud round-trip, and stays manageable through ALPON Cloud.

The steps below are identical on ALPON X4 and ALPON X5 AI. For further configuration, supported protocols, and support, see the official FUXA documentation.

Before you start

You need an ALPON X5 AI or ALPON X4 registered on ALPON Cloud, and Docker installed on your build machine to pull and push the image. New to container deployment? Start with Containerize Apps for ALPON.

  1. 1

    Add the FUXA container

    Make sure the frangoteam/fuxa image is available to your device. The recommended path is to push it to your Sixfab Container Registry so deployments are fast and work offline. From your build machine, pull the arm64 image:

    bash · pull the image 
    docker pull --platform linux/arm64 frangoteam/fuxa:latest

    Then log in to Sixfab Registry, click + Add Container, and follow the prompts to push the image.

    Pushing images to the Sixfab Container Registry

    For the full walkthrough of tagging and pushing an image, see Update Containers from the Sixfab Container Registry.

    Alternative: deploy straight from Docker Hub

    If you prefer not to use the Sixfab Container Registry, choose “I would like to use my own container path” during deployment and enter frangoteam/fuxa:latest. The container is then pulled directly from Docker Hub (the device needs internet access at deploy time).

  2. 2

    Deploy the container on ALPON

    Open your device in ALPON Cloud, go to the Applications section, and click + Deploy. In the Deploy Container window, use these settings:

    Container Name fuxa
    Image The FUXA image and tag you pushed to the Sixfab Container Registry — or, using the alternative option, frangoteam/fuxa:latest.
    Ports Click + Add More and map host port 31881 to container port 1881.
    Volumes Click + Add More and add the four volumes in the table below.
    FromTo
    318811881
    Read/WriteLocal PathTarget Path
    Read/Write/tmp/fuxa_appdata/usr/src/app/FUXA/server/_appdata
    Read/Write/tmp/fuxa_db/usr/src/app/FUXA/server/_db
    Read/Write/tmp/fuxa_logs/usr/src/app/FUXA/server/_logs
    Read/Write/tmp/fuxa_images/usr/src/app/FUXA/server/_images
    Where the data lives

    The four /tmp/fuxa_* directories on the device hold FUXA’s project data, database, logs, and uploaded images, so your projects survive a container restart or update.

    Click + Deploy to launch FUXA on the device.

  3. 3

    Open the FUXA dashboard

    Once the deployment finishes, find the device's local IP address under Asset Details → Network tab → Interface Monitoring → Details, then open the dashboard in a browser:

    browser · FUXA dashboard 
    http://<DEVICE_IP>:31881

    The FUXA editor should load. Once the dashboard is accessible, you can use FUXA to monitor and control your devices. If it doesn't load, confirm the container is running in the Applications section and that the 31881 → 1881 port mapping was added in step 2.

    Security considerations
    • Use strong credentials for accessing the FUXA dashboard.
    • Regularly update the container to the latest version.
    • Monitor network access to ensure only authorized users can reach the system.
Ready when…
  • The fuxa container shows as running in the Applications section.
  • The dashboard loads at http://<DEVICE_IP>:31881.
  • Projects you save in the FUXA editor survive a container restart.

FUXA is now running on the ALPON. Add your device connections and build your first view from the FUXA editor.

Production image policy: Replace floating :latest references with a reviewed immutable tag or digest, then record the selected version for rollback.

Continue exploring

Related guides

Build on this workflow with deployment, fleet-management, and hardware guidance for the ALPON platform.

Workflow Deploy Applications on ALPON Push an ARM64 image, configure its runtime, and launch it from ALPON Cloud. Open guide Platform ALPON Cloud Manage devices, applications, connectivity, and remote operations from one workspace. Open guide Hardware Compare ALPON devices Compare ALPON X4 and ALPON X5 AI capabilities for your edge workload. Open guide

Updated 16 days ago

Did this page help you?