Quick Start (5 minutes)
This guide assumes the installation is already complete. It walks you through connecting a single PLC and verifying that data is being received.
If you need to start from the installation, see One-line Installation (2026.05+ container mode) or
install.sh generates a random password for each box during first installation and prints it once to /etc/kopens/credentials.txt
(chmod 0600 root). If the initial password for your first UI login is not the default, check it via
sudo cat /etc/kopens/credentials.txt over the box's SSH.
1. Access the Web Interface
Open the gateway address in your web browser.
http://<gateway-ip>/
| Item | Value |
|---|---|
| Default ID | admin |
| Default Password | admin123! |
Please change the default password you received as soon as possible. Go to the [Settings]
menu (gear icon in the top right), update edge.admin_password, and click Save and Restart —
see Password / API Key Change.
After logging in, you'll see the main dashboard. It displays CPU / memory / disk usage gauges and PLC connection status. The video above walks you through the key things to look at on this screen — the PLC connection count and the read success/failure counts. These two numbers tell you whether the gateway is doing its job.
2. Go to the [Connections] Menu
Click [Connections] in the top menu.
- If this is your first time, you'll see an empty [Connections] table.
- Click the blue [Add Connection] button in the top right to proceed.
3. Select the PLC Type
After clicking [Add Connection], the "Select the PLC or protocol to register" screen appears. Click the card that matches your equipment type.
| Your Equipment | Card to Select |
|---|---|
| OPC-UA server like Kepware | OPC-UA |
| Standard 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 in | HTTP |
| Just want to test without a PLC | Simulator |
If you're a first-time user and don't have a PLC, we recommend starting with the Simulator. It generates fake PLC data automatically, making it a great way to learn the interface first.
4. Fill Out the Registration Form
The input fields vary slightly depending on the selected PLC type, but they generally ask for the following information.
| Input Field | What to Enter |
|---|---|
| Connection Name | The name shown on the screen (e.g., 1라인 미쓰비시) |
| IP Address | The PLC's IP address (e.g., 192.168.0.60) |
| Port | The PLC's communication port (defaults listed on each PLC page) |
| Collection Interval | How often to read (in ms; usually 1000 = 1 second) |
| Auto Start | Whether to start collection automatically when the gateway reboots |
Refer to the PLC Type-Specific Guides page for detailed input instructions for each PLC.
5. Register Tags (= Values to Read)
Registering a PLC connection alone won't fetch any data. You must also register which addresses to read — these are called [Tags].
| Input Field | What to Enter |
|---|---|
| Tag Name | The name shown on the screen (e.g., 펌프1 RPM) |
| PLC Address | The address used in the PLC manual or existing SCADA (e.g., Mitsubishi D100) |
| Data Type | One of Float, Integer, Boolean, String |
Format Assist (format) | DW for 32-bit, REAL for floating point, etc. (refer to each PLC page) |
See the Tag Registration page for details. Address notation varies by PLC, so it's fastest to refer to your specific PLC type's page in conjunction with this guide.
6. [Save] → Automatic Collection Begins
Click [Save], and the gateway will attempt to connect to the PLC and immediately start collecting values. Wait a moment. The first value typically arrives within 1-3 seconds.
7. Verify That Values Are Coming In
Return to the [Connections] menu, and you'll see your registered PLC on the left.
- If the collection badge on the card is green and shows "Normal", and the connection icon on the right is also green (tooltip "Connected"), you're all set.
- Click the PLC, and the list of registered tags and their current values will appear on the right, auto-refreshing every 5 seconds.
If the connection icon is red (tooltip "Disconnected"), check the IP / port / firewall settings. For a detailed troubleshooting flow, see the Troubleshooting page.
Next Steps
| What to Try Next | Page |
|---|---|
| Apply unit conversion to values (e.g., raw integer value ×0.1 to float) | Apply Formula |
| Register multiple tags for the same PLC | Tag Registration |
| View time series graphs / history | View Collection History |
| Having issues? | Troubleshooting |