Enable the Puppet Core repositories on RPM-based systems

The procedure for enabling the Puppet Core repositories on RPM-based systems differs, depending on the operating system of the packages that you want to install.

Enable the Puppet Core repositories for SUSE Linux Enterprise Server packages

For SUSE Linux Enterprise Server packages, complete the following steps:

1. Install the Puppet GPG key:

   curl -LO https://yum-puppetcore.puppet.com/public/RPM-GPG-KEY-puppet-20250406

2. Install the SUSE Linux Enterprise Server release package:

   rpm -Uvh https://yum-puppetcore.puppet.com/public/puppet8-release-sles-15.noarch.rpm

3. Add credentials to the /etc/zypp/credentials.d/PuppetcoreCreds file, where forge-key is a string literal and <API_KEY> is your API key from Puppet Forge:

   username=forge-key
   password=<API_KEY>

4. Install the agent by following the instructions in Installing and configuring agents.

Enable the Puppet Core repositories for other packages

To install packages that are not associated with SUSE Linux Enterprise Server, complete the following steps:

1. Run the RPM tool in upgrade mode:

   sudo rpm -Uvh <package_URL>

   For example, to enable the Enterprise Linux 8 repository:

   sudo rpm -Uvh https://yum-puppetcore.puppet.com/public/puppet8-release-el-8.noarch.rpm

2. Uncomment and update the username and password in the /etc/yum.repos.d/<file_name>.repo file:

   #username=forge-key
   #password=<API_KEY>

   forge-key is a string literal.

   See the following example.

   $ sudo vi /etc/yum.repos.d/puppet8-release.repo
   [puppet8]
   name=Puppet 8 Repository el 8 - $basearch
   baseurl=https://yum-puppetcore.puppet.com/puppet8/el/8/$basearch
   gpgkey=file:///etc/pki/rpm-gpg/<gpg_key>
   enabled=1
   gpgcheck=1
   ## Add authentication here by uncommenting and filling in values
   username=forge-key
   password=<API_KEY>