Install PDK on Debian or Ubuntu

After you configure credentials for PDK, you can download, install, and upgrade it.

Configure credentials

To download, install, or install PDK, which is stored in a protected repository, you must download authenticated packages using either Puppet Core or Puppet Enterprise (PE) credentials. Use the following steps to add credentials to your repository configuration.

Add authentication credentials. In your /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf file, uncomment the login and password lines.

Edit the username and password to add credentials. Use either Puppet Core or PE credentials.

  • Puppet Core: The string literal forge-key as the username and the Puppet Core 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.

  • PE: The string literal license-id as the username 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.

Install PDK

Use the following steps to download and install PDK and its dependencies. Use the commands appropriate to your OS. Make sure you Configure credentials for PDK before updating the package manager.

  1. Update the package manager.

    • Debian 10

      Copy 
      wget https://apt-puppetcore.puppet.com/public/puppet8-release-buster.deb
      sudo dpkg -i puppet8-release-buster.deb
      # Before you update, edit /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf
      sudo apt-get update

    • Debian 11

      Copy 
      wget https://apt-puppetcore.puppet.com/public/puppet8-release-bullseye.deb
      sudo dpkg -i puppet8-release-bullseye.deb
      # Before you update, edit /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf
      sudo apt-get update

    • Debian 12

      Copy 
      wget https://apt-puppetcore.puppet.com/public/puppet8-release-bookworm.deb
      sudo dpkg -i puppet8-release-bookworm.debsudo 
      # Before you update, edit /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf
      apt-get update

    • Ubuntu 18.04

      Copy 
      wget https://apt-puppetcore.puppet.com/public/puppet8-release-bionic.deb
      sudo dpkg -i puppet8-release-bionic.deb
      # Before you update, edit /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf
      sudo apt-get update

    • Ubuntu 20.04

      Copy 
      wget https://apt-puppetcore.puppet.com/public/puppet8-release-focal.deb
      sudo dpkg -i puppet8-release-focal.deb
      # Before you update, edit /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf
      sudo apt-get update

    • Ubuntu 22.04

      Copy 
      wget https://apt-puppetcore.puppet.com/public/puppet8-release-jammy.deb
      sudo dpkg -i puppet8-release-jammy.deb
      # Before you update, edit /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf
      sudo apt-get update

    • Ubuntu 24.04

      Copy 
      wget https://apt-puppetcore.puppet.com/public/puppet8-release-noble.deb
      sudo dpkg -i puppet8-release-noble.deb
      # Before you update, edit /etc/apt/auth.conf.d/apt-puppetcore-puppet.conf
      sudo apt-get update

  2. Install the PDK package. Run:

    Copy 
    sudo apt-get install pdk

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

Upgrade PDK

To upgrade your PDK installation to the most recent release, Configure credentials for PDK and then run:

Copy 
sudo apt-get update
sudo apt-get install pdk