iis Cookbook

(opens in a new tab) (opens in a new tab) (opens in a new tab)

Description

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

Maintainers

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 (opens in a new tab) or come chat with us on the Chef Community Slack in #sous-chefs (opens in a new tab).

Requirements

Platforms

Windows Server 2016
Windows Server 2019

Chef

Chef 12.14+

Cookbooks

windows if running on chef < 16

Attributes

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

Resources

Recipies

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

default recipe

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

mod_* recipes

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.

Contributors

This project exists thanks to all the people who contribute. (opens in a new tab)

Backers

Thank you to all our backers!