This Version of PyScada is BETA software and may have serious bugs which may cause damage to your computer, automation hardware and data. It is not intended for use in production systems! You use this Software on your own risk!


This installation guide covers the installation of PyScada for Debian 7/8/9 , Raspbian, Fedora 22/23 based Linux systems using MySQL / MariaDB or SQLite as Database, Gunicorn as WSGI HTTP Server and nginx as HTTP Server.


Debian 9, Raspbian

sudo -i
apt-get update
apt-get -y upgrade
# if you use MariaDB/MySQL as Database system (recommend)
apt-get -y install mariadb-server python3-mysqldb
apt-get install -y python3-pip libhdf5-100 libhdf5-dev python3-dev nginx

pip3 install gunicorn
pip3 install pyserial
pip3 install docutils


  • MySQL Server <>
brew install python
export PATH=$PATH:/usr/local/mysql/bin
pip install MySQL-python


sudo -i
pip3 install

# for VISA Protocol
pip3 install pyvisa pyvisa-py
# for 1Wire Protocol
apt-get install owfs #
pip3 install pyownet
# for smbus Protocol, install libffi-dev first!
apt-get install libffi-dev
pip3 install smbus-cffi

Add a new system-user for Pyscada (optional, recommend)

Add a dedicated user for the pyscada server instance and add a directory for static/media files.


sudo -i
useradd -r pyscada
mkdir -p /var/www/pyscada/http
chown -R pyscada:pyscada /var/www/pyscada
mkdir -p /home/pyscada
chown -R pyscada:pyscada /home/pyscada


sudo -i
dscl . -create /Users/pyscada IsHidden 1
dscl . -create /Users/pyscada NFSHomeDirectory /Users/pyscada
LastID=`dscl . -list /Users UniqueID | awk '{print $2}' | sort -n | tail -1`
NextID=$((LastID + 1))
dscl . create /Users/pyscada UniqueID $NextID
dscl . create /Users/pyscada PrimaryGroupID 20
mkdir -p /var/www/pyscada/http
chown -R pyscada:staff /var/www/pyscada/

Create a MySql Database

Create the Database and grand the nessesery permission. Replace PyScada_db, PyScada-user and PyScada-user-password as you like.

mysql -uroot -p -e "CREATE DATABASE PyScada_db CHARACTER SET utf8;GRANT ALL PRIVILEGES ON PyScada_db.* TO 'PyScada-user'@'localhost' IDENTIFIED BY 'PyScada-user-password';"

Create a new Django Project

# Linux/OSX
cd /var/www/pyscada/
sudo -u pyscada django-admin startproject PyScadaServer

see Django Settings for all necessary adjustments to the django and

Initialize Database And Copy Static Files

cd /var/www/pyscada/PyScadaServer # linux
sudo -u pyscada python3 migrate
sudo -u pyscada python3 collectstatic

# load fixtures with default configuration for chart lin colors and units
sudo -u pyscada python3 loaddata color
sudo -u pyscada python3 loaddata units

# initialize the background service system of pyscada
sudo -u pyscada python3 pyscada_daemon init

Add a Admin User To Your Django Project

cd /var/www/pyscada/PyScadaServer
sudo -u pyscada python3 createsuperuser

Setup the Webserver (nginx, gunicorn)

# debian
sudo wget -O /etc/nginx/sites-available/pyscada.conf

# Fedora
sudo wget -O /etc/nginx/conf.d/pyscada.conf

after editing, enable the configuration and restart nginx, optionally remove the default configuration

to use ssl (https, recommend)

generate ssl certificates.

# for Debian, Ubuntu, Raspian
sudo mkdir /etc/nginx/ssl
# the certificate will be valid for 5 Years,
sudo openssl req -x509 -nodes -days 1780 -newkey rsa:2048 -keyout /etc/nginx/ssl/pyscada_server.key -out /etc/nginx/ssl/pyscada_server.crt
# debian
sudo ln -s /etc/nginx/sites-available/pyscada.conf /etc/nginx/sites-enabled/
sudo rm /etc/nginx/sites-enabled/default

now it’s time to [re]start nginx.

# systemd (Debian 8, Fedora, Ubuntu > XX.XX)
sudo systemctl enable nginx.service # enable autostart on boot
sudo systemctl restart nginx

# SysV-Init (Debian 7, Ubuntu <= XX.XX, [Debian 8])
sudo service nginx restart

for Fedora you have to allow nginx to serve the static and media folder.

sudo chcon -Rt httpd_sys_content_t /var/www/pyscada/http/

add gunicorn and pyscada unit files:

# systemd
sudo wget -O /etc/systemd/system/gunicorn.socket
sudo wget -O /etc/systemd/system/gunicorn.service
sudo wget -O /etc/systemd/system/pyscada.service

# in some installations gunicorn is not at /usr/local/bin/gunicorn but at /usr/bin/gunicorn
# in this case you have to change the pat in the file /etc/systemd/system/gunicorn.service accordingly

# enable the services for autostart
sudo systemctl enable gunicorn
sudo systemctl start gunicorn
sudo systemctl enable pyscada

Start PyScada

sudo systemctl start pyscada