Skip to content

Update NuGet feed docs with note that hierarchical feeds are not supported #2882

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 3 commits into
base: main
Choose a base branch
from
Open

Update NuGet feed docs with note that hierarchical feeds are not supported #2882

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6baf68e
Update subscription events for consistency with product
wlthomson Aug 20, 2025
6e1848f
Add note that hierarchical local nuget feeds are not supported
wlthomson Oct 21, 2025
2dc7e69
Update modification date for subscriptions documentation
steve-fenton-octopus Oct 28, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions src/pages/docs/administration/managing-infrastructure/subscriptions/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
---
layout: src/layouts/Default.astro
pubDate: 2023-01-01
modDate: 2025-04-16
modDate: 2025-10-28
title: Subscriptions
description: Subscriptions allow you to subscribe to events that are happening within Octopus, so you can be notified when events have occurred and react accordingly.
navOrder: 1600
Expand Down Expand Up @@ -138,6 +138,7 @@ The following is a list of all options for subscriptions including Event Groups,
| EVENT GROUPS |
|-----------------------------------------------|
| API key expiry events |
| Authentication banned events |
| Auto-deploy events |
| Auto-Deploy critical-events |
| Certificate expiry events |
Expand Down Expand Up @@ -170,6 +171,8 @@ The following is a list of all options for subscriptions including Event Groups,
| Certificate private-key exported |
| Certificate replaced |
| Comment |
| Compliance Policy evaluated |
| Deployment canceled |
| Deployment failed |
| Deployment precondition evaluated |
| Deployment queued |
Expand All @@ -187,7 +190,7 @@ The following is a list of all options for subscriptions including Event Groups,
| License key expired \* |
| License key expiry 10-day warning \* |
| License key expiry 20-day warning \* |
| License usage at 80% warning \*\ |
| License usage at 80% warning \*\* |
| License usage at 90% warning \*\* |
| License usage at 95% warning \*\* |
| License usage at limit \*\* |
Expand All @@ -205,6 +208,8 @@ The following is a list of all options for subscriptions including Event Groups,
| Machine found to be unhealthy |
| Machine found to have warnings |
| Manual intervention interruption raised |
| Package added to built-in feed \*\*\* |
| Package deleted from built-in feed \*\*\* |
| Package deleted by package repository index sync |
| Package deleted by package repository retention policy |
| Package replaced |
Expand Down Expand Up @@ -306,3 +311,5 @@ The following is a list of all options for subscriptions including Event Groups,
\* License key expiry events are only available in Octopus Server version `2025.2.6402` and later.

\*\* License usage events are only available in Octopus Server version `2025.2.7065` and later.

\*\*\* Package added to/deleted from built-in feed events are only available in Octopus Server version `2025.3.9484` and later.
6 changes: 6 additions & 0 deletions src/pages/docs/packaging-applications/package-repositories/nuget-feeds.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,12 @@ On the test page, you can check whether the feed is working by searching for pac

Learn more about [hosting your own NuGet Feeds](https://docs.nuget.org/create/hosting-your-own-nuget-feeds)

:::div{.info}

Note: Local packages must be stored in a single folder. Octopus does not currently support hierarchical local NuGet feeds.

:::

## NuGet.Server performance

A popular external NuGet hosting option is **NuGet.Server**. However, be aware that it suffers from performance problems when dealing with large packages or large numbers of smaller packages. Users may report high CPU usage, timeouts when displaying package details, or memory issues. A great alternative that we recommend is [NuGet.Lucene](https://github.com/themotleyfool/NuGet.Lucene).
Expand Down