Device Management

The doover device and doover device-type command groups manage devices and their types on the Doover platform. Devices represent physical or virtual edge nodes, while device types define hardware templates with shared configuration.

Listing Devices

doover device list

Lists devices with optional filtering:

# Search by name
doover device list --search "pump"

# Filter by application
doover device list --application my-app

# Filter by group
doover device list --group "factory-floor"

# Filter by group tree (includes nested groups)
doover device list --group-tree "factory-floor"

# Filter by device type
doover device list --type "doovit-v3"

Filtering Options

Filter	Description
`--name` / `--name-contains` / `--name-icontains`	Name matching
`--display-name` / `--display-name-contains` / `--display-name-icontains`	Display name matching
`--id`	Filter by device ID (repeatable for multiple IDs)
`--application`	Filter by installed application
`--group`	Filter by exact group
`--group-tree`	Filter by group and all sub-groups
`--type`	Filter by device type
`--organisation`	Filter by organisation
`--archived`	Filter by archive status
`--search`	Full-text search
`--ordering`	Sort expression (prefix `-` for descending)
`--page` / `--per-page`	Pagination

Getting Device Details

doover device get <device-id-or-name>

The argument can be a device ID, name, or display name.

Creating and Updating Devices

doover device create --name "pump-station-01" --type doovit-v3
doover device update my-device --display-name "Pump Station 01"

The create and update commands accept options matching the device model fields. Available fields are dynamically generated from the platform API.

Archiving Devices

doover device archive my-device
doover device unarchive my-device

Device Installers

The CLI can download device provisioning installers in several formats. These are used to set up new hardware with the Doover agent.

Installer Info

doover device installer-info my-device

Shows the installer configuration for a device without downloading it.

Download Installer Script

doover device installer my-device
doover device installer my-device --output ./install.sh

Download as Tarball

doover device installer-tarball my-device
doover device installer-tarball my-device --output ./installer.tar.gz

Download as ZIP

doover device installer-zip my-device
doover device installer-zip my-device --output ./installer.zip

Device App Installations

Manage application installations on a specific device:

# List installations
doover device app-installs list my-device

# Get installation details
doover device app-installs get my-device my-install

# Create a new installation
doover device app-installs create my-device

# Update an installation
doover device app-installs update my-device my-install

# Deploy an installation
doover device app-installs deploy my-device my-install

# Archive/unarchive
doover device app-installs archive my-device my-install
doover device app-installs unarchive my-device my-install

# Delete an installation permanently
doover device app-installs delete my-device my-install --yes

# Sync config profiles
doover device app-installs sync-config-profiles my-device my-install --config-profile-id 1

# List deployments for an installation
doover device app-installs deployments my-device my-install

# Get a specific deployment
doover device app-installs deployment my-device my-install <deployment-id>

Device Tunnels

Manage tunnels scoped to a specific device. See Tunnel Commands for the full tunnel reference.

doover device tunnels list my-device
doover device tunnels create my-device --name ssh --hostname localhost --port 22 --protocol tcp

Device Types

Device types define hardware templates. Use doover device-type to manage them.

Listing Device Types

doover device-type list
doover device-type list --search "doovit"

Getting a Device Type

doover device-type get doovit-v3

Creating and Updating

doover device-type create --name "custom-sensor-v1"
doover device-type update custom-sensor-v1 --name "custom-sensor-v2"

Uploading Installers

Upload installer scripts or tarballs to a device type:

# Upload a single installer script
doover device-type upload-installer doovit-v3 ./install.sh

# Upload an installer directory as a tarball
doover device-type upload-installer-tar doovit-v3 ./installer/

Doover CLI Overview -- global options and command groups
Tunnel Commands -- managing remote access tunnels
App Management -- application commands including app-install