Thursday, April 12, 2012

Custom puppet master hostname error hostname was not match with the server certificate

 When you want to use custom hostname for puppet it shows the following error.
err: Could not retrieve catalog from remote server: hostname was not match with the server certificate
warning: Not using cache on failed catalog
err: Could not retrieve catalog; skipping run
err: Could not send report: hostname was not match with the server certificate

 In my case I wanted to use the default hostname "puppet" . Add the following entries to puppet master configuration file /etc/puppet/puppet.conf

 certname = puppet

stop puppet master; mv /var/lib/puppet /var/lib/puppet-bak

start puppet

 Ensure that the cert is loaded with the name you want.

puppet cert print $(puppet master --configprint certname)|grep Subject

        Subject: CN=puppet

If the CN field is showing your hostname then this would not work.

Now you can use puppet agents to connect using

puppet agent --test --server puppet

Ensure that you have entries in /etc/hosts for puppet master


  1. Kudos to the author for this invaluable article! Your clear instructions and troubleshooting steps for resolving the Puppet hostname mismatch issue are a lifesaver. Much appreciated efforts.
    Is iim skills fake?

  2. Finally got my puppet master sorted thanks to this post! Smooth sailing now.
    Data Analytics Courses In Gujarat

  3. good blog
    Data Analytics Courses In Vadodara

  4. This comment has been removed by the author.

    1. Your examination of the subject is comprehensive and clear, and I'm eager to read more of your work.
      data Analytics courses in leeds

  5. The "Custom puppet master hostname" error typically occurs in Puppet configuration when the master's hostname is not recognized, often requiring adjustments to the configuration file for a successful connection. While unrelated to Puppet errors, London offers excellent Data Analytics courses, equipping professionals with the skills to analyze and derive insights from diverse datasets. Please also Digital Marketing Courses in London .


  6. "Very helpful blog addressing the 'Custom Puppet Master Hostname' error! Your detailed walkthrough on resolving the hostname mismatch with the server certificate is a lifesaver. The clear steps and explanations offer a practical solution for users encountering this issue. Thanks for providing such a valuable resource, making it easier for others to navigate and troubleshoot this common problem in Puppet setups."
    Investment banking course details