Skip to main content

Windows IIS Proxy

With a few extra steps you can run PaGetto behind a Windows IIS proxy. This has many benefits, including automatic restarts on reboots.

IIS setup​

  1. Install the ASP.NET Core 10 Hosting Bundle on the web server.
  2. Copy the PaGetto directory over to your hosting area such as C:\Inetpub\wwwroot\PaGetto
  3. Using IIS Manager, create a new Application Pool:
    • Name = PaGettoAppPool (can be whatever you want)
    • .NET CLR version = No Managed Code
    • Managed Pipeline Mode = Integrated
    • Start application pool immediately = checked
  4. Using IIS Manager, create a new web site:
    • Choose your site name and physical path
    • Choose PaGettoAppPool as the application pool
    • In the Binding area, enter the default PaGetto port of 5000

PaGetto folder permissions​

You may need to give special permissions to the top-level PaGetto folder so that the app can persist its state. This is necessary as the Application Pools' identity is a virtual account that isn't recognized by the Windows User Management Console. For more information, please refer to ASP.NET Core's documentation:

Settings outside the site folder​

Instead of editing appsettings.json in the site folder, you can put your settings in C:\ProgramData\PaGetto\appsettings.json. It overrides the site's appsettings.json and survives redeploys. Give the application pool identity (e.g. IIS AppPool\PaGettoAppPool) read access to it. See Machine-wide config file.

Alternative storage path​

info

Virtual Directories do not work with IIS and Kestrel. For more information, please refer to ASP.NET Core's documentation.

Ensure that the configuration's storage Path has the appropriate forward slashes:

...
  "Storage": {
    "Type": "FileSystem",
    "Path": "C://AnotherFolder/Packages"
  },
...

Note that you will need to adjust folder permissions if the Path is created outside of the PaGetto top-level directory. See the PaGettot Folder Permissions.

IIS server options​

Settings such as the maximum package size can be configured for IIS in the appsettings.json file - see IIS Server Options.