Attention

IronPLC supports IEC 61131-3 Structured Text excluding I/O mapping.

Installation

IronPLC supports the following platforms:

  • Windows (x64, arm64)

  • macOS (x64, arm64)

  • Linux (x64)

Prerequisites

The first step is to install a supported development environment:

Other development environments that support VS Code extensions (via the Open VSX Registry) also work. The instructions below use Visual Studio Code, but the steps are the same in all supported environments.

Install Steps

Follow the steps below to install IronPLC.

Install IronPLC CLI

  1. Download the latest IronPLC installer from IronPLC GitHub releases:

  2. Run the installer and follow the prompts to complete installation of the CLI.

Install IronPLC Extension

Run your development environment, then:

  1. Go to the Extensions view by clicking on the Extensions icon in Activity Bar on the side of the window or using the View: Extensions command (Ctrl+Shift+X).

  2. In the Extensions view, enter IronPLC in the search box.

  3. In the Extensions view for the IronPLC item, choose Install.

Install IronPLC CLI

Option 1 — Homebrew (recommended):

  1. Go to Homebrew then follow the instructions to install Homebrew.

  2. In a Terminal, enter brew tap ironplc/tap, then enter brew install ironplc.

Option 2 — install script:

curl -fsSL https://www.ironplc.com/install.sh | sh

This installs ironplcc, ironplcvm, and ironplcmcp into $HOME/.ironplc/bin and adds that directory to your PATH via your shell profile.

Install IronPLC Extension

Run your development environment, then:

  1. Go to the Extensions view by clicking on the Extensions icon in Activity Bar on the side of the window or using the View: Extensions command (⌘+Shift+X).

  2. In the Extensions view, enter IronPLC in the search box.

  3. In the Extensions view for the IronPLC item, choose Install.

Install IronPLC CLI

Run the following in a terminal:

curl -fsSL https://www.ironplc.com/install.sh | sh

This installs ironplcc, ironplcvm, and ironplcmcp into $HOME/.ironplc/bin and adds that directory to your PATH via your shell profile.

To install a specific version:

curl -fsSL https://www.ironplc.com/install.sh | IRONPLC_VERSION=v0.201.0 sh

Prebuilt binaries are currently provided for x86_64 Linux only.

Install IronPLC Extension

Run your development environment, then:

  1. Go to the Extensions view by clicking on the Extensions icon in Activity Bar on the side of the window or using the View: Extensions command (Ctrl+Shift+X).

  2. In the Extensions view, enter IronPLC in the search box.

  3. In the Extensions view for the IronPLC item, choose Install.

Next Steps

You are ready to start programming. In the next chapter, you will learn how PLC programs work before writing your first one.

Continue to How a PLC Program Works.