Installs and configures Microsoft Internet Information Services (IIS) 7.0 and later

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

• Windows Server 2016
• Windows Server 2019

• Chef 12.14+

• windows if running on chef < 16

• node['iis']['home'] - IIS main home directory. default is %WINDIR%\System32\inetsrv
• node['iis']['conf_dir'] - location where main IIS configs lives. default is %WINDIR%\System32\inetsrv\config
• node['iis']['pubroot'] - . default is %SYSTEMDRIVE%\inetpub
• node['iis']['docroot'] - IIS web site home directory. default is %SYSTEMDRIVE%\inetpub\wwwroot
• node['iis']['cache_dir'] - location of cached data. default is %SYSTEMDRIVE%\inetpub\temp

• iis_app
• iis_config_property
• iis_config
• iis_install
• iis_manager
• iis_manager_permission
• iis_module
• iis_pool
• iis_root
• iis_section
• iis_site
• iis_vdir

These recipies still exist but are highly likely to be removed in future major releases of this cookbook.

Installs and configures IIS 7.0/7.5/8.0 using the default configuration.

This cookbook also contains recipes for installing individual IIS modules (extensions). These recipes can be included in a node's run_list to build the minimal desired custom IIS installation.

• mod_aspnet - installs ASP.NET runtime components
• mod_aspnet45 - installs ASP.NET 4.5 runtime components
• mod_auth_basic - installs Basic Authentication support
• mod_auth_windows - installs Windows Authentication (authenticate clients by using NTLM or Kerberos) support
• mod_compress_dynamic - installs dynamic content compression support. PLEASE NOTE - enabling dynamic compression always gives you more efficient use of bandwidth, but if your server's processor utilization is already very high, the CPU load imposed by dynamic compression might make your site perform more slowly.
• mod_compress_static - installs static content compression support
• mod_ftp - installs FTP service
• mod_iis6_metabase_compat - installs IIS 6 Metabase Compatibility component.
• mod_isapi - installs ISAPI (Internet Server Application Programming Interface) extension and filter support.
• mod_logging - installs and enables HTTP Logging (logging of Web site activity), Logging Tools (logging tools and scripts) and Custom Logging (log any of the HTTP request/response headers, IIS server variables, and client-side fields with simple configuration) support
• mod_management - installs Web server Management Console which supports management of local and remote Web servers
• mod_security - installs URL Authorization (Authorizes client access to the URLs that comprise a Web application), Request Filtering (configures rules to block selected client requests) and IP Security (allows or denies content access based on IP address or domain name) support.
• mod_tracing - installs support for tracing ASP.NET applications and failed requests.

Note: Not every possible IIS module has a corresponding recipe. The foregoing recipes are included for convenience, but users may also place additional IIS modules that are installable as Windows features into the node['iis']['components'] array.

This project exists thanks to all the people who contribute.

Thank you to all our backers!

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.