Quick Start — First PLC in 5 Minutes
This guide assumes installation is already complete. We'll walk you through connecting one PLC and verifying that data is flowing.
If you need to install from scratch, see Quick Install (2026.05+ container mode) or Full H/W Setup (legacy native).
install.sh generates a random password for each box on first setup and prints it once to /etc/kopens/credentials.txt
(chmod 0600 root). If the UI first login password is not the default, check via SSH to the box using sudo cat /etc/kopens/credentials.txt.
1. Open the Web Interface
Open the gateway address in your web browser.
http://<gateway-ip>/
| Item | Value |
|---|---|
| Default ID | admin |
| Default Password | admin123! |
Change the default password you received as soon as possible. Go to the gear icon [Settings]
menu in the top right, update edge.admin_password, and click Save and Restart —
see Password · API Key Change.
After login, the main screen appears. You'll see CPU / memory / disk usage gauges and PLC connection status.
2. Go to the [Connection] Menu
Click [Connection] in the top menu.
- On first access, you'll see an empty [Connection List] table.
- Click the blue [Add Connection] button in the top right to proceed.
3. Select PLC Type
When you click [Add Connection], a screen appears asking "Select the PLC or protocol to connect." Click the card that matches your equipment.
| Equipment You Have | Select This Card |
|---|---|
| OPC-UA server like Kepware | OPC-UA |
| General Modbus TCP slave (most instruments) | Modbus |
| Mitsubishi PLC | MELSEC (Mitsubishi) |
| Siemens PLC | S7 (Siemens) |
| LS ELECTRIC PLC | LS |
| AB / Rockwell PLC | EtherNet/IP |
| External system will send values | HTTP |
| Test without a PLC | Simulator |
If you're new and don't have a PLC, we recommend starting with Simulator. Fake PLC data flows in automatically, so you can learn the interface first.
4. Fill Out the Registration Form
Input fields vary slightly by PLC type, but these are common:
| Input Field | What to Enter |
|---|---|
| Connection Name | Display name (example: 1라인 미쓰비시) |
| IP Address | PLC IP address (example: 192.168.0.60) |
| Port | PLC communication port (default shown on each PLC page) |
| Collection Interval | How often to read, in ms (typically 1000 = 1 second) |
| Auto-Start | Automatically start collection when gateway reboots |
For detailed instructions on each PLC type, see Protocol Guide.
5. Register Tags (= Values to Read)
Just registering a PLC connection doesn't pull any data. You must also register which addresses to read — these are called tags.
| Input Field | What to Enter |
|---|---|
| Tag Name | Display name (example: 펌프1 RPM) |
| PLC Address | Address from PLC manual or existing SCADA (example: Mitsubishi D100) |
| Data Type | One of Float, Integer, Boolean, String |
Format Option (format) | For 32-bit, use DW; for float, use REAL, etc. (see your PLC page) |
For details, see Add Tag. Address notation varies by PLC, so check your specific PLC type page for the fastest results.
6. [Save] → Collection Starts Automatically
Click [Save] and the gateway attempts to connect to the PLC and immediately begins data collection. Wait a moment. First values usually arrive within 1–3 seconds.
7. Verify Data Is Flowing
Go back to the [Connection] menu and you'll see your registered PLC on the left.
- If the Connection Status box is green "Connected", you're good.
- Click the PLC to see the registered tags and current values on the right, auto-refreshed every 5 seconds.
If you see red "Connection Failed", check IP / port / firewall. For detailed troubleshooting steps, see Troubleshooting.
Next Steps
| What to Try Next | Page |
|---|---|
| Apply unit conversion to values (example: scale integer raw value by ×0.1) | Apply Formula |
| Register multiple tags on the same PLC | Add Tag |
| View time series graphs / history | View Collection History |
| Something isn't working | Troubleshooting |