1.4 Installing OpenPLC Runtime on Linux

Welcome! We are excited that you want to learn more about OpenPLC. This page contains step-by-step instructions on how to get OpenPLC Runtime installed in your system. The OpenPLC Runtime can run on a variety of Linux systems, but it works better on Debian-based distributions like Ubuntu and Raspbian.

The best way to get OpenPLC Runtime into your device is by using git. Usually, git comes preinstalled on most Linux distributions. If for some reason you don’t have git installed on your system, you can install it by opening terminal and typing:

sudo apt-get install git

To install OpenPLC, type these lines on terminal:

git clone https://github.com/thiagoralves/OpenPLC_v3.git

cd OpenPLC_v3

./install.sh linux

If you are installing OpenPLC on a specific Linux hardware, like the Raspberry Pi for example, you must replace the ‘linux’ parameter with your platform specific argument:

./install.sh rpi

Below are the valid arguments for the installer:

  • win – Install OpenPLC on Windows over Cygwin
  • linux – Install OpenPLC on a Debian-based Linux distribution
  • docker – Install OpenPLC in a Docker container
  • rpi – Install OpenPLC on a Raspberry Pi
  • neuron – Install OpenPLC on a UniPi Neuron PLC
  • custom – Skip all specific package installation and tries to install OpenPLC assuming your system already has all dependencies met

 

The installation process will take a while (up to 1 hour depending on your system). Meanwhile, grab a [insert your favorite beverage here] and relax! Once OpenPLC is installed, just reboot your device and it will start automatically after boot.

Platform Specific Differences

Neuron PLC

To avoid compatibility problems, it is better to download the most recent UniPian Neuron OS from the UniPi website and make a fresh install. Also, keep in mind that when OpenPLC is installed on UniPian, it completely disables EVOK and all related services.​

UniPi Industrial Platform

Before starting OpenPLC runtime, you will need to load the I2C module into the kernel. This will enable OpenPLC to communicate with the I2C peripherals on your UniPi board. To load the I2C module, type:

​gpio load i2c

A reboot is needed after using this command. You only need to type it once.