Download

ForgeIEC components at a glance

ForgeIEC consists of several components. Which ones you need depends on your role:

Installation from the package repository

ForgeIEC is provided as a signed Debian repository at apt.forgeiec.io and as a signed RPM repository at rpm.forgeiec.io. Setup is a one-time step per workstation or target PLC — pick your distribution:

# Signier-Schluessel hinterlegen
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.forgeiec.io/forgeiec.gpg \
  | sudo tee /etc/apt/keyrings/forgeiec.gpg >/dev/null

# Repository-Quelle eintragen
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/forgeiec.gpg] \
https://apt.forgeiec.io/trixie trixie main" \
  | sudo tee /etc/apt/sources.list.d/forgeiec.list

sudo apt update

# Signier-Schluessel importieren
sudo rpm --import https://rpm.forgeiec.io/forgeiec-rpm.asc

# Repository eintragen
sudo tee /etc/yum.repos.d/forgeiec.repo >/dev/null <<'EOF'
[forgeiec]
name=ForgeIEC
baseurl=https://rpm.forgeiec.io/el9/$basearch/
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://rpm.forgeiec.io/forgeiec-rpm.asc
EOF

sudo dnf makecache

Then install components individually:

# Workstation
sudo apt install forgeiec-studio          # ForgeIEC Studio
sudo apt install forgeiec-fdd-data        # Device descriptions (recommended)

# Target PLC
sudo apt install forgeiec-anvil-server    # PLC runtime (anvild + all tongs-*)
sudo apt install forgeiec-bellows-server  # HMI gateway (bellowsd)

# Operator panel
sudo apt install forgeiec-screen-wayland  # Kiosk on Wayland
sudo apt install forgeiec-screen-xorg     # Kiosk on X11

On RPM systems the commands read sudo dnf install … with otherwise identical package names.

The bus bridges (tongs-modbustcp, tongs-ethercat, tongs-profibus, tongs-ethernetip) are not separate packages — they live inside forgeiec-anvil-server and are started by anvild.

Updates follow the standard apt update && apt upgrade cycle — no manual .deb files needed.

Supported platforms

Debian / Ubuntu (apt.forgeiec.io)

Suite mapping: bullseye = Debian 11, bookworm = Debian 12, trixie = Debian 13, jammy = Ubuntu 22.04, noble = Ubuntu 24.04.

Enterprise Linux / Fedora (rpm.forgeiec.io)

RPM delivery is new and currently covers the operator panel only. ForgeIEC Studio and the runtime will follow once their RPM slots are stable.

There are two different signing keys: forgeiec.gpg (ed25519) for apt and forgeiec-rpm.asc (RSA-4096) for rpm. The difference is not cosmetic — RHEL 9 ships rpm 4.16, whose internal PGP parser cannot verify ed25519.

arm64 is deliberately absent on the RPM side: the CI cross-compile path depends on Debian packages that do not exist on Enterprise Linux.

Windows build of ForgeIEC Studio: in preparation. Until then Studio runs natively on Linux or via WSL2 on Windows workstations.

Direct downloads (release tarballs)

If you cannot or do not want to use the package repository — e.g. for air-gap workstations — you can download individual releases directly from the repository pages:

• ForgeIEC Studio source: GitHub / Forgejo
• anvild + bridges: Forgejo
• bellowsd: Forgejo
• Website source: GitHub / Forgejo

Per release, signed .deb packages + source tarballs are attached to the GitHub/Forgejo release tag.

Building from source

# Clone the repository (with submodules)
git clone --recurse-submodules https://github.com/Beerlesklopfer/ForgeIEC-Studio.git
cd ForgeIEC-Studio

# Build Studio + all daemons
cd build && cmake .. -DCMAKE_BUILD_TYPE=Release && make -j$(nproc)

# Deploy on the local system
./deploy.sh all

Prerequisites:

• Debian 12/13 or Ubuntu 24.04+
• build-essential cmake qt6-base-dev qt6-declarative-dev libtomlplusplus-dev
• Rust 1.85+ (via rustup)

Demo projects

Example projects shipped with ForgeIEC Studio:

Found in Studio under File → Open Example.

Next steps

• First steps with ForgeIEC Studio
• Setting up the AI assistant
• Bus configuration
• News + release notes