Skip to content
bondlegend4 edited this page Sep 3, 2024 · 6 revisions

An open-source project for a supervisory control and data acquisition system is a Kubernetes-based, multi-platform solution that simulates a SCADA environment.

GitHub release (latest by date including pre-releases) GitHub Release DateGitHub
DockerDocker Image Size (tag)

Quick start

Works on:

Installation

The easiest way to start with V-ICS is to launch the docker environment that is described inside docker-compose.yml file. You need to have a Docker engine installed on your machine.

First

git clone https://github.com/bondlegend4/V-ICS/
cd V-ICS

Building OpenPLC

After installation build and run the OpenPLC container.

# in the OpenPLC_v3 directory, run:
docker build -t openplc:v3 .

Devices can be passed to the docker daemon using the -v flag (e.g. -v /dev/ttyACM0:/dev/ttyACM0)

docker run -it --rm --privileged -p 8080:8080 openplc:v3

Running the application

Once OpenPLC container had been built move back to the V-ICS directory and you can type:

docker compose up

That command will start the "database" and "scadalts" docker containers, and then you can access the application at the following address from your browser: localhost:8080/Scada-LTS. Default user: admin/admin.

  • IMPORTANT NOTE!
    Sometimes, the "scadalts" docker container is loaded faster than the "database," so you can see that the application is not available. To fix that problem, you can start them manually in the following order:

    docker compose up database
    docker compose up scadalts
    

That script download the latest stable version of Scada-LTS from our official Docker Hub repository. More details how to configure the application can be found in our docker tutorial.

  • Important note! To download the latest version, use the latest tag in your scadalts/scadalts image name. You can also download the nightly version of Scada-LTS that is build from the pre-release workflow. It may not be stable but you can test the latest changes by your own.

Local deployment

Navigation within application

📚 Example scenario

Are you new to the V-ICS? 

Social channels

Youtube

Development

GitHubJavaSpringMySQL

Are you new to our project? Do you want to start adding some awesome stuff? First, you have to install all required libraries and dependencies. To make it easier, we prepared a step-by-step tutorial. Then, if your application has been built successfully, you can start developing new features. For people who do not know what to do at the beginning, we prepared instructions for VSCodium [to be written].

Preparing the environment

Code Documentation

Quick tips

Rules

One rule to rule them all!
To keep our project clean, we introduced some rules that should be obeyed. They are described in the following sections:

Authors

Jose Sandoval Github LinkedIn instagram