Install on Debian or Ubuntu

Install PDK with the APT package manager.

Use the following steps to download and install PDK and its dependencies. Use the commands appropriate to your OS. This version of PDK is stored in a protected repository, so you must authenticate using either your Puppet Core or Puppet Enterprise (PE) credentials.

  1. Update the package manager.

    • Debian 10

      wget https://apt-puppetcore.puppet.com/public/puppet8-release-buster.deb
      sudo dpkg -i puppet-release-buster.deb
      sudo apt-get update

    • Debian 11

      wget https://apt-puppetcore.puppet.com/public/puppet8-release-bullseye.deb
      sudo dpkg -i puppet-release-bullseye.deb
      sudo apt-get update

    • Debian 12

      wget https://apt-puppetcore.puppet.com/public/puppet8-release-bookworm.deb
      sudo dpkg -i puppet-release-bookworm.deb
      sudo apt-get update

    • Ubuntu 18.04

      wget https://apt-puppetcore.puppet.com/public/puppet8-release-bionic.deb
      sudo dpkg -i puppet-release-bionic.deb
      sudo apt-get update

    • Ubuntu 20.04

      wget https://apt-puppetcore.puppet.com/public/puppet8-release-focal.deb
      sudo dpkg -i puppet-release-focal.deb
      sudo apt-get update

    • Ubuntu 22.04

      wget https://apt-puppetcore.puppet.com/public/puppet8-release-jammy.deb
      sudo dpkg -i puppet-release-jammy.deb
      sudo apt-get update

    • Ubuntu 24.04

      wget https://apt-puppetcore.puppet.com/public/puppet8-release-noble.deb
      sudo dpkg -i puppet-release-noble.deb
      sudo apt-get update

  2. Add authentication credentials. In your /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf file, uncomment the login and password lines. Add either of the following sets of credentials, ensuring that you use either a Forge login and password or a PE login and password.

    • The string literal forge-key as the login and the Puppet Forge API key associated with your Puppet Core free or paid user as the password. For more information about the API key, see Purchasing Puppet Core and Accessing Puppet Core for limited use for testing or development.

    • The string literal license-id as the login and your PE License ID as the password. You can find your PE License ID in your PE license file or in the PE console by selecting License from the navigation bar.

  3. Install the PDK package.

    Run sudo apt-get install pdk

  4. Open a terminal to re-source your shell profile and make PDK available to your PATH.

Upgrade PDK on Debian or Ubuntu

To upgrade your PDK installation to the most recent release, run: 

sudo apt-get update
sudo apt-get install pdk