Custom upgrade instructions URL #10255

Closed
opened 2025-12-29 21:29:01 +01:00 by adam · 1 comment
Owner

Originally created by @pgnuta on GitHub (Sep 17, 2024).

NetBox version

v4.1.0

Feature type

New functionality

Proposed functionality

It would be useful for enterprises who maintain their own deployment/upgrade processes and accompanying documentation if the "Upgrade instructions" URL displayed on the home page when a new Netbox version is available could be customized.

Currently the URL Is hard-coded to "https://docs.netbox.dev/en/stable/installation/upgrading/" in netbox/templates/home.html. I propose that a configuration variable be added, like CUSTOM_UPGRADE_URL, and defaulted it to "https://docs.netbox.dev/en/stable/installation/upgrading/". The configuration variable can then be used when rendering the template.

Use case

Many netbox users have custom methodologies for deploying and upgrading Netbox. Whether that be deployment via automation, docker, test environments etc. In those cases the standard Netbox upgrade instructions may not be appropriate and it may be preferred to refer the operations team to the internal documentation URL.

Database changes

None

External dependencies

Accompanying documentation updates would be required to explain the use of the new configuration variable.

Originally created by @pgnuta on GitHub (Sep 17, 2024). ### NetBox version v4.1.0 ### Feature type New functionality ### Proposed functionality It would be useful for enterprises who maintain their own deployment/upgrade processes and accompanying documentation if the "Upgrade instructions" URL displayed on the home page when a new Netbox version is available could be customized. Currently the URL Is hard-coded to "https://docs.netbox.dev/en/stable/installation/upgrading/" in netbox/templates/home.html. I propose that a configuration variable be added, like CUSTOM_UPGRADE_URL, and defaulted it to "https://docs.netbox.dev/en/stable/installation/upgrading/". The configuration variable can then be used when rendering the template. ### Use case Many netbox users have custom methodologies for deploying and upgrading Netbox. Whether that be deployment via automation, docker, test environments etc. In those cases the standard Netbox upgrade instructions may not be appropriate and it may be preferred to refer the operations team to the internal documentation URL. ### Database changes None ### External dependencies Accompanying documentation updates would be required to explain the use of the new configuration variable.
adam added the type: featurenetbox labels 2025-12-29 21:29:02 +01:00
adam closed this issue 2025-12-29 21:29:02 +01:00
Author
Owner

@jeremystretch commented on GitHub (Jan 23, 2025):

While I appreciate your use case, this seems like a very niche ask. Additionally, directing users to a non-canonical source may lead to confusion should they request help from the community.

@jeremystretch commented on GitHub (Jan 23, 2025): While I appreciate your use case, this seems like a very niche ask. Additionally, directing users to a non-canonical source may lead to confusion should they request help from the community.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#10255