Forge Home


Puppet Caddy Module


1,516 latest version

5.0 quality score

Version information

  • 2.0.0 (latest)
  • 1.0.0
  • 0.2.0
released May 14th 2020
This version is compatible with:
  • Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x
  • Puppet >= 5.5.8 < 7.0.0
  • , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'puppet-caddy', '2.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add puppet-caddy
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install puppet-caddy --version 2.0.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Tags: web, caddy


puppet/caddy — version 2.0.0 May 14th 2020

Puppet module for Caddy

Build Status Code Coverage Puppet Forge Puppet Forge - downloads Puppet Forge - endorsement Puppet Forge - scores License

Table of Contents

  1. Description
  2. Setup - The basics of getting started with Caddy
  3. Usage - Configuration options and additional functionality
  4. Limitations - OS compatibility, etc.
  5. Development - Guide for contributing to the module


This module installs and configures Caddy - The HTTP/2 web server with automatic HTTPS.


What Caddy affects

  • Caddy binary
  • Caddy configuration file
  • Caddy virtual hosts
  • Caddy service

Setup Requirements

This module has the following dependencies:

Beginning with Caddy

Install Caddy without any configuration:

include caddy


Install customised version of Caddy

class { 'caddy':
  caddy_features => 'http.git,http.filter,http.ipfilter',

Install specific version of Caddy

class { 'caddy':
  version        => '1.0.3',
  install_method => 'github',

Install Caddy and configure virtual host, based on source:

caddy::vhost { 'example1':
  source => 'puppet:///modules/caddy/etc/caddy/config/example1.conf',

Install Caddy and configure virtual host, based on content:

caddy::vhost { 'example2':
  content => 'localhost:2015',


The reference documentation of this module is generated using puppetlabs/puppetlabs-strings.


This module has been tested on:

  • RedHat 6/7/8
  • CentOS 6/7/8
  • Debian 8/9/10
  • Ubuntu 16.04/18.04


This module has grown over time based on a range of contributions from people using it. If you follow these contributing guidelines your patch will likely make it into a release a little more quickly.


This module is maintained by Vox Pupuli. It was originally written and maintained by Lukasz Rohde.