Setup & Installation

Follow these steps to get your IoT devices connected and managed

🐧 Ubuntu/Debian
🎩 CentOS/RHEL
Alpine Linux
🖥️ Custom Linux
1 of 3
1

Prerequisites

  • Debian or Debian derivative (Ubuntu, Raspberry OS)
  • Supports the apt package manager
  • Has systemctl installed and configured
  • Host OS is readable and writable
  • Device has an active internet connection
2

Run Installer Script

This script will setup the service. It will install (if not already installed) OpenSSH server, Docker, Docker compose, NetworkManager, OpenSSL and gzip. It's recommended to choose a strong encryption token.

Terminal
export ENCRYPTION_TOKEN='mytoken'
apt-get update && apt-get install -y curl
curl -L https://raw.githubusercontent.com/IoTDeviceManager/DeviceManagerClient/refs/heads/main/docs/install/debian/install_debian.sh | env ENCRYPTION_TOKEN="$ENCRYPTION_TOKEN" bash -s -- --no-input
What this does: Installs the offline IoT manager service and its dependencies.
3

Verify Installation

We will now validate that the installation was successful. If not, see our troubleshooting tips below, or contact us. For additional details about how to use the offline IoT manager, please visit our GitHub Page.

Access the dashboard (admin/admin):
4

Register Device (Optional)

Doing so will allow you to manage your device in an online manner as well, provided it has stable internet access.

Terminal
[Not available at this time]
Note: The online management functionality is still in development.
5

Check Device In Dashboard (Optional)

Feature not available at this time.

1

Prerequisites

  • Red Hat derivative (RHEL, CentOS, etc.)
  • Supports the dnf package manager
  • Has systemctl installed and configured
  • Host OS is readable and writable
  • Device has an active internet connection
2

Run Installer Script

This script will setup the service. It will install (if not already installed) OpenSSH server, Docker, Docker compose, NetworkManager, OpenSSL and gzip. It's recommended to choose a strong encryption token.

Terminal
export ENCRYPTION_TOKEN='mytoken'
dnf install -y curl
curl -L https://raw.githubusercontent.com/IoTDeviceManager/DeviceManagerClient/refs/heads/main/docs/install/cent/install_cent.sh | env ENCRYPTION_TOKEN="$ENCRYPTION_TOKEN" bash -s -- --no-input
What this does: Installs the offline IoT manager service and its dependencies.
3

Verify Installation

We will now validate that the installation was successful. If not, see our troubleshooting tips below, or contact us. For additional details about how to use the offline IoT manager, please visit our GitHub Page.

Access the dashboard (admin/admin):
4

Register Device (Optional)

Doing so will allow you to manage your device in an online manner as well, provided it has stable internet access.

Terminal
[Not available at this time]
Note: The online management functionality is still in development.
5

Check Device In Dashboard (Optional)

Feature not available at this time.

1

Prerequisites

  • Machine is running Alpine Linux
  • Supports the apk package manager
  • Has OpenRC installed and configured
  • Host OS is readable and writable
  • Device has an active internet connection
2

Run Installer Script

This script will setup the service. It will install (if not already installed) OpenSSH server, Docker, Docker compose, NetworkManager, OpenSSL and gzip. It's recommended to choose a strong encryption token.

Terminal
export ENCRYPTION_TOKEN='mytoken'
wget -qO- https://raw.githubusercontent.com/IoTDeviceManager/DeviceManagerClient/refs/heads/main/docs/install/alpine/install_alpine.sh | env ENCRYPTION_TOKEN="$ENCRYPTION_TOKEN" sh -s -- --no-input
What this does: Installs the offline IoT manager service and its dependencies.
3

Verify Installation

We will now validate that the installation was successful. If not, see our troubleshooting tips below, or contact us. For additional details about how to use the offline IoT manager, please visit our GitHub Page.

Access the dashboard (admin/admin):
4

Register Device (Optional)

Doing so will allow you to manage your device in an online manner as well, provided it has stable internet access.

Terminal
[Not available at this time]
Note: The online management functionality is still in development.
5

Check Device In Dashboard (Optional)

Feature not available at this time.

1

Prerequisites

  • Docker, OpenSSH server, OpenSSL, bash, and curl are installed (Required)
  • Device has an active internet connection (Required)
  • An initialization system is installed (Recommended)
  • Network is managed by networkmanager (Recommended)
  • Docker compose and gzip are installed (Recommended)
2

Run Installer Script

TThis script will setup the service. It is recommended to use an initialization system to persist the service, as well as choose a strong encryption token. The device will be rebooted.

Terminal
export ENCRYPTION_TOKEN='mytoken'
curl -L https://raw.githubusercontent.com/IoTDeviceManager/DeviceManagerClient/refs/heads/main/docs/install/custom/install_custom.sh | env ENCRYPTION_TOKEN="$ENCRYPTION_TOKEN" bash -s -- --no-input
What this does: Installs the offline IoT manager service and its dependencies.
3

Verify Installation

We will now validate that the installation was successful. If not, see our troubleshooting tips below, or contact us. For additional details about how to use the offline IoT manager, please visit our GitHub Page.

Access the dashboard (admin/admin):
4

Register Device (Optional)

Doing so will allow you to manage your device in an online manner as well, provided it has stable internet access.

Terminal
[Not available at this time]
Note: The online management functionality is still in development.
5

Check Device In Dashboard (Optional)

Feature not available at this time.

Need Help?

Access/Installation Issues?

Either open a discussion or contact us for help.

Do You Support Windows/MAC?

The service can be installed on these OS, but may not provide the full functionality. For more info, please contact us.

Does the dashboard have an API?

Yes! The OpenAPI spec can be accessed at http://[deviceIP]:15000/docs.

What system hardware is required?

Minimum system requirements are 2GB of ram, 8GB storage, and a 1 core CPU. Works on x86-64 or ARM64 systems.