App Management

The doover app command group manages the full lifecycle of Doover applications — from scaffolding a new project to building containers and publishing to the platform.

doover app create

This launches an interactive wizard that:

1. Prompts for a name and description
2. Fetches the application template from GitHub
3. Creates the project directory with the correct structure
4. Initialises a git repository
5. Updates doover_config.json with the application metadata

doover app list

Lists applications with optional filtering:

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

# Filter by type
doover app list --type docker

# Filter by organisation
doover app list --organisation "my-org"

# Paginate results
doover app list --page 2 --per-page 10

The list command supports field-specific filters with comparison operators:

doover app get my-application

The argument can be an application ID or an exact name match.

doover app build

Builds the Docker container for the application in the current directory. Uses docker buildx by default for multi-platform builds.

Extra arguments are passed through to the underlying docker build command.

doover app build-widget

Builds the application's UI widget. Runs the build command specified in doover_config.json, or falls back to npm run build.

doover app run

Runs the application locally using Docker Compose. Extra arguments are passed through to docker compose.

# Run on a remote Docker host
doover app run 192.168.1.100 --port 2375

doover app publish

Publishes the application to the Doover platform. This is the primary deployment command and performs several steps:

1. Exports the config schema
2. Exports the UI schema
3. Builds the UI widget
4. Uploads the widget
5. Updates the application record on the platform

doover app publish --build-container

This builds and pushes the Docker image in addition to the standard publish steps.

doover app put-widget

Uploads a pre-built widget file to the platform. This is done automatically during publish, but can be run independently.

doover app test

Runs pytest for the application. Extra arguments are passed through to pytest.

doover app lint
doover app lint --fix

Runs ruff linter. Use --fix to auto-fix issues.

doover app format
doover app format --fix

Runs ruff formatter.

# Archive an application
doover app archive my-application

# Unarchive
doover app unarchive my-application

doover app channels

Opens the Doover channel viewer in your browser, connected to the local Device Agent. Useful for inspecting channel data during local development.

Application installations can be managed through three paths:

• doover app-install — top-level commands (not scoped to an app or device)
• doover app installs — scoped to a specific application
• doover device app-installs — scoped to a specific device

The doover app installs subcommands mirror the device-scoped commands but take an application ID as the first argument:

# List installations for an application
doover app installs list my-app

# Create an installation scoped to an application
doover app installs create my-app

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

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

Available subcommands: list, get, create, update, archive, unarchive, delete, deploy, sync-config-profiles, deployments, deployment.

See Device Management for device-scoped installation commands.

• Doover CLI Overview -- global options and output formats
• Config Schema -- exporting and validating config schemas
• Application Class -- the Python application class these commands deploy