Skip to main content

General

5-Minute Quick Start

Deploy Proxus using Docker and connect your first simulated device.

This guide will walk you through deploying the Proxus stack locally and connecting a simulated device to witness real-time data flow.

Prerequisites

Docker Engine 4GB+ RAM

Ensure you have Docker and Docker Compose installed on your machine.

Deployment

The fastest way to get Proxus running is using our automated installer. Run the following command in your terminal:

curl -fsSL https://www.proxus.io/scripts/install.sh | bash

Once the script completes, start the stack:

cd proxus-platform
docker compose up -d

Wait about 30-60 seconds for the containers to initialize. Then open the Management Console at http://localhost:8080.

Management Console overview
Management Console overview

info
Login Credentials
  • Username: Admin
  • Password: (Leave blank)
warning
License Key

Proxus requires a license to activate gateways. You can request a free demo license at proxus.io/demo.

Connecting a Simulator

Since you likely do not have a physical PLC connected to your development machine, we will use the built-in Simulator protocol to generate data.

Create a Device Profile

  1. Navigate to Data Management > Device Profiles in the sidebar.
  2. Click New.
  3. Name it Simulated Generator.
  4. Select Protocol: SIMULATOR.
  5. Add the following Tags (the Address field defines the [min,max] range):
    • Name: Temperature, Address: [20,80], Type: Double
    • Name: Vibration, Address: [0,5], Type: Double
    • Name: Status, Address: [0,1], Type: Bool
  6. Click Save.

Add the Device

  1. Navigate to Data Management > Devices.
  2. Click New.
  3. Name: Gen_01.
  4. Profile: Select Simulated Generator.
  5. Gateway: Select the default SYSTEM gateway (this is the local gateway installed with your server).
  6. Click Save.

Activate

In the devices list, find Gen_01. You will notice it is Passive by default. Check the Active box. The system will deploy the configuration to the Gateway immediately.

Verify Data Flow

To confirm that data is flowing into the platform:

  1. Click on the Gen_01 device name to open the details view.
  2. Switch to the Latest Values tab.
  3. You should see Temperature and Vibration values updating in real-time.

Latest Values tab with live data
Latest Values tab with live data

Congratulations! You have successfully deployed Proxus and ingested your first data stream.

Next Steps

Now that you have live data, explore the platform architecture or start building automation rules.

account_tree

Architecture Overview

Understand the Hub & Spoke topology and data flow.

schema

Unified Namespace

Learn how to structure your data hierarchy.

toggle_on

Create Rules

Build logic to detect anomalies in your simulated data.

← Previous
Introduction to Proxus
Next →
System Requirements