Installing the Smallstep App Agent on Linux

The Smallstep App is a desktop client of the Smallstep Agent.

Check our system requirements for running the Smallstep Agent on Linux

Debian Package

  • Download the flatpak from our downloads page
  • Install the Smallstep App Debian Package

    Aptitude
    sudo apt-get install [path_to_deb_package]

    Note: dpkg -i is not recommended due to possible package dependency failures.
    In order to successfully detect your device's TPM, you need to be in the tss group
    • Check if you're a member of the tss group
      getent group tss
    • Add a user to the tss group and reboot the machine.
      sudo usermod -a -G tss [username]

Uninstalling Debian Package

Aptitude

sudo apt-get remove smallstep-desktop

dpkg

sudo dpkg -r smallstep-desktop

Note: dpkg -i is not recommended due to possible package dependency failures.

Flatpak

  • Download the flatpak from our downloads page.
  • As a local user, either click on the flatpak package to install it or run
    flatpak install [path_to_flatpak]
  • In order to successfully detect your device's TPM, you need to be in the TSS group
    • Check if you're a member of the tss group
      getent group tss
    • Add a user to the tss group
      sudo usermod -a -G tss [username]
  • Launch the Smallstep App from your apps menu.

Uninstalling Flatpak

Flatpak uninstalls need to be done from the command line

flatpak remove smallstep