WEDA Node Installation

Enabling WEDA Node (First-Time Setup)

Select "Install WEDA Node" from the main menu to run the setup wizard. The wizard walks through 10 steps.

Step 1 of 10 — License Agreement

  WEDA NODE INSTALLATION WIZARD
Step 1 of 10

WEDA Node End User License Agreement
...

[ ] I have read and accept the terms and conditions

Scroll: ↑/↓ • Space: Page down / accept at bottom • Enter: Continue • Esc: Cancel

Scroll to read the full license (↑/↓ or Space to page down)
At the bottom, press Space to check acceptance: [☑]
Press Enter to continue

Step 2 of 10 — Credential Source

Step 2 of 10

How would you like to set up your device credentials?

  ⦿ Connect to Public WEDA Site
      Automatically provisions this device on the public WEDA platform

  ○ Download from WEDA Core
      Log in to your WEDA Core server and download credentials automatically

  ○ Use Local Credential File
      I already have a device credential file (.bin) from WEDA Core

Prerequisite: Register your device at the WEDA server before proceeding

Option A — Connect to Public WEDA Site (default)

Best for standard Advantech devices connecting to the public WEDA Cloud.

Select "Connect to Public WEDA Site" and press Enter
The built-in master key bundled with the installer is used automatically
No login or external file required
Proceeds directly to Step 7 — Device Model

Expected results: Device is automatically provisioned on the public WEDA platform on first service start.

Option B — Download from WEDA Core

Best when you have a private WEDA Core server and want automatic credential download.

Select "Download from WEDA Core" and press Enter
Step 3 — Select login method: Password or Token
Step 4 — Enter your WEDA Core server URL, username, and password (Tab between fields)
Step 5 — Select your organization from the list
Credentials are downloaded and saved automatically
Proceeds to Step 7 — Device Model

Expected results: Device is registered on your WEDA Core server and credentials are saved locally.

Option C — Use Local Credential File

Best for offline deployments or pre-provisioned devices.

Select "Use Local Credential File" and press Enter
Step 6 — Select authentication method:

Method File Use When
Auto Provision Master Key (.bin) Mass deployment — one key provisions many devices
Device Credentials Setup Device Credential (.bin) Single device with a pre-downloaded credential file
Press Enter to open the file picker and navigate to your .bin file:

Key Action
↑/↓ Navigate files
← Go to parent directory
→ / Enter on folder Open directory
Enter on file Select file
n Confirm selection and proceed
Esc Cancel

Method	File	Use When
Auto Provision	Master Key (`.bin`)	Mass deployment — one key provisions many devices
Device Credentials Setup	Device Credential (`.bin`)	Single device with a pre-downloaded credential file

Key	Action
↑/↓	Navigate files
←	Go to parent directory
→ / Enter on folder	Open directory
Enter on file	Select file
n	Confirm selection and proceed
Esc	Cancel

Expected result: Credential file is copied to /opt/Advantech/dmagent/res/.

Step 7 of 10 — Device Model

Step 7 of 10

Configure your device model:

  EPC-U2217

The device model has been automatically detected from your system.

Enter: Continue • Esc: Go Back

Automatically read from /etc/board. Read-only — press Enter to continue.

Step 8 of 10 — Review and Confirm

Step 8 of 10

Review your installation configuration:

  Authentication:    Auto Provision
  Device Model:      EPC-U2217
  ...

Enter: Begin Installation • Esc: Go Back

Review the summary and press Enter to start.

Step 9 of 10 — Installing

Step 9 of 10

Installing WEDA Node

Progress: [████████████████░░░░░] 65%

Downloading Docker images...

Fast Network: 2-3 minutes
Slow Network: 5-10 minutes
Do NOT close the terminal or press Ctrl+C

Step 10 of 10 — Complete

Step 10 of 10

✓ WEDA Node Successfully Installed

Installation Details:
  ...

You can now manage your installation from the dashboard.

Enter: Continue to Dashboard

Press Enter to go to the Management Panel.

Management Panel

Access via "Manage WEDA Node" from the main menu.

┌──────────────────────────────────────────────────┐
│  WEDA Node Activator                             │
└──────────────────────────────────────────────────┘

Service Status Overview

╭──────────────────────────────────────────────────╮
│ Current Status                                   │
│                                                  │
│ Service Status:   ● Running                      │
│ Connection:       ● Connected                    │
│ Version:          1.0.0                          │
│ Uptime:           2h 34m                         │
│ Auth Method:      Auto Provision                 │
│ Provision State:  Registered                     │
│                                                  │
│ Connection Details                               │
│   Device: Device ID: 74fe488d5d54, Model: ...    │
│   Server: 219.87.150.116:4222                    │
╰──────────────────────────────────────────────────╯

When provision state is not registered (e.g. REG_FAILED), the box shows an onboarding note:

╭──────────────────────────────────────────────────╮
│ Current Status                                   │
│                                                  │
│ Service Status:   ● Running                      │
│ Connection:       ✗ Disconnected                 │
│ ...                                              │
│ Provision State:  REG_FAILED: Not registered     │
│                                                  │
│  [Note: Onboarding This Device ]                 │
│  Browse below URL: Request your WEDA Account &   │
│  Register your device at WEDA server             │
│  https://learn.advantech.com/weda/docs/Introduction│
╰──────────────────────────────────────────────────╯

Management Actions

Management Actions

 > [*] Update Authentication Credentials
         Change WEDA Node authentication credentials

   [*] Restart Service
         Restart all WEDA Node containers

       Remove WEDA Node
         Uninstall and remove all components

↑/↓: Navigate • Enter: Select Action • q/Esc: Back to Main Menu • Ctrl+C: Quit

Action	Description
Update Authentication Credentials	Replace the master key or credential file without reinstalling
Restart Service	Stop and restart all WEDA Node Docker containers
Remove WEDA Node	Uninstall containers, volumes, and configuration (type `REMOVE` to confirm)

Service Dashboard

Access via the "Service Dashboard" option or the d shortcut (where available). Shows real-time container status.

┌──────────────────────────────────────────────────┐
│  SERVICE DASHBOARD                               │
└──────────────────────────────────────────────────┘

╭──────────────────────────────────────────────────╮  ← green border when connected
│ Connection Status                                │
│                                                  │
│   Provision State:   ● Registered                │
│   Server:            ● Connected                 │
│   Device:            Device ID: 74fe488d5d54...  │
╰──────────────────────────────────────────────────╯

Container Services

╭──────────────────────────────────────────────────╮  ← blue border when selected
│ ●  WEDA Node(dmagent)                            │
│                                                  │
│   Status:       running                          │
│   Health:       ok                               │
│   Uptime:       2h 34m                           │
╰──────────────────────────────────────────────────╯

╭──────────────────────────────────────────────────╮
│ ●  system-agent                                  │
│                                                  │
│   Status:       running                          │
│   Health:       ok                               │
│   Uptime:       2h 34m                           │
╰──────────────────────────────────────────────────╯

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
↑/↓: Navigate • a: Restart All Services • q/Esc: Back • Ctrl+C: Quit

Status icons:

● green — running / connected / registered
○ grey — stopped / unknown
✗ red — failed / disconnected

Connection box color:

Green border — device connected to WEDA server
Red border — REG_FAILED or container not found
Grey border — intermediate states

The dashboard auto-refreshes every 5 seconds.

Keyboard Reference

Global Shortcuts

Key	Action
`↑`/`↓` or `j`/`k`	Navigate up/down
`Enter`	Select/Confirm
`Space`	Toggle checkbox/radio button
`Esc`	Cancel/Return to previous screen
`Ctrl+C`	Force quit application
`q`	Quit (Main Menu only)

Contextual

Screen	Key	Action
License	`Space`	Page down / check acceptance at bottom
WEDA Core Login	`Tab` / `Shift+Tab`	Cycle between input fields
WEDA Core Login	`t`	Toggle self-signed certificate trust
File Picker	`←`	Go to parent directory
File Picker	`→` / `Enter`	Open folder / select file
File Picker	`n`	Confirm selection and proceed
Service Dashboard	`a`	Restart all services
Remove Node	`Type REMOVE`	Confirm uninstallation

Last updated on Feb-10, 2026 | Version 1.0

Enabling WEDA Node (First-Time Setup)​

Step 1 of 10 — License Agreement​

Step 2 of 10 — Credential Source​

Option A — Connect to Public WEDA Site (default)​

Option B — Download from WEDA Core​

Option C — Use Local Credential File​

Step 7 of 10 — Device Model​

Step 8 of 10 — Review and Confirm​

Step 9 of 10 — Installing​

Step 10 of 10 — Complete​

Management Panel​

Management Actions​

Service Dashboard​

Keyboard Reference​

Global Shortcuts​

Contextual​

Is this helpful?