oasiot/oas-linux repository overview

⁠Quick reference

• Maintained by: Open Automation Software⁠
• Support: All inquiries and bug reports should be forwarded to [email protected]⁠
• Detailed Documentation: More information about the OAS Platform and running in Docker can be found here⁠.

⁠Supported architectures

OAS maintains a separate repository for each supported OS/Architecture which can be found here:

• oas-linux⁠ : Linux on both x64 and AMD64
• oas-linux-arm⁠ : Linux on ARM32
• oas-linux-arm64⁠ : Linux on ARM64
• oas-win⁠ : Windows on x64
• oas-win-amd64⁠ : Windows on AMD64

⁠Supported Tags

• latest will always provide the most recent build
• All previous builds can be pulled using a version number tag. See the full tag list⁠.

⁠What is OAS?

Open Automation Software (OAS) is an IIoT Gateway for connecting data sources and destinations. OAS supports connectivity to a wide variety of devices including Allen Bradley, Siemens, and Modbus PLCs, cloud-based IoT gateways such as AWS and Azure, MQTT clients and brokers, and OPC UA and DA servers. With the included SDKs and APIs for .NET, REST, and Web technologies, OAS can literally connect and move data between any external system.

OAS also supports high-speed data logging in an open format to many databases (MSSQL, Oracle, mySQL, PostgreSQL, MongoDB, MariaDB, Cassandra, SQLite, InfluxDB, and CSV files). The OAS Platform also includes support for data transformations, robust alarm logging and notifications (email, SMS, voice), and tools for visualization and dashboarding in desktop, web, and native mobile applications.

⁠How to use this image

⁠Pull the image

$ docker pull oasiot/oas-linux

⁠Start an OAS instance

Run a container using defaults:

$ docker run oasiot/oas-linux

Run a container using an interactive terminal session:

$ docker run -it oasiot/oas-linux

⁠Management and configuration

The OAS Platform can be fully managed and configured from a remote system. This is especially useful when operating a headless server or when running OAS within a container. The OAS Windows Installer contains a GUI for managing remote systems. Just download and install the Windows version, found here⁠.

⁠A note about ports

The OAS Platform uses several ports for communication, primarily 58727 for remote management and server-to-server data transfer. The full listing of ports mapped in the image are:

When running an oas-linux container on a Windows host, you will not be able to communicate with the container on the IP Address assigned by the Docker Engine. Any or all of these ports can be mapped to localhost ports when running a container. For example, if you want to map 58727 to localhost:58727, use the following command to run the container:

$ docker run -p 58727:58727 oasiot/oas-linux

⁠Licensing

The OAS Platform is a commercial product, however it is free to use for development and testing on a 30-day trial. Applying a demo or purchased license requires you to run the LicenseHost service on the host machine. This can be found here⁠.