Workstation Tools

reference

This document details troubleshooting steps for common problems with Mender workstation tools (mender-artifact and mender-cli).

mender-artifact

Error: flag provided but not defined: -c

The -c flag for mender-artifact was introduced in version 4.3.0. If you are using an older version (e.g. 3.9.0 from the default Ubuntu 24.04/Noble repository), you will see this error when trying to use the -c flag.

Solutions:

  1. Use the legacy -t flag instead of -c in your commands. For example: 
    mender-artifact write rootfs-image -t device-type -n artifact-name ...
  1. Upgrade to the latest version by following the installation instructions or manually downloading the binary.

Error: /bin/sh: 1: mender: not found

This error occurs when using mender-artifact version older than 4.0.0 with Mender 4.0+ devices. The older mender-artifact versions are incompatible with the newer device client.

Solution:

Upgrade your mender-artifact to version 4.0.0 or later by following the installation instructions.

Verify your installation

To check which version of mender-artifact you have installed:

mender-artifact --version

The recommended version is 4.3.0 or later for full compatibility with current documentation examples.

mender-cli

Verify your installation

To check which version of mender-cli you have installed:

mender-cli --version

For installation and upgrade instructions, see Workstation Tools.

We welcome contributions to improve this documentation. To submit a change, use the Edit link at the top of the page or email us at .