starred/netbox
1
0
Fork 0
mirror of https://github.com/netbox-community/netbox.git synced 2026-01-11 21:10:29 +01:00
Code Issues 273 Packages Projects Releases 10 Wiki Activity

Add CentOS 8.1 to installation documentation #3584

New Issue
Closed
opened 2025-12-29 18:30:00 +01:00 by adam · 8 comments
adam commented 2025-12-29 18:30:00 +01:00
Owner
Copy Link

Originally created by @ariesgeek on GitHub (Apr 18, 2020).

Change Type

[X] Addition
[ ] Correction
[ ] Deprecation
[ ] Cleanup (formatting, typos, etc.)

Area

[X] Installation instructions
[ ] Configuration parameters
[ ] Functionality/features
[ ] REST API
[ ] Administration/development
[ ] Other

Proposed Changes

The current CentOS installation instructions reference CentOS 7.5 and appear to be accurate for that OS version. CentOS 8.1 is different from 7.5, in that it includes a new package manager in dnf, it now ships with a supported version of PostgreSQL, which serves to simplify the installation overall, and some of the required packages have changed.

I recently installed NetBox in a fresh CentOS 8.1 environment and updated the existing installation documentation as I proceed through the steps. I can submit a pull request, but wanted to make sure I had this documentation change issue written up first.

Originally created by @ariesgeek on GitHub (Apr 18, 2020). ### Change Type [X] Addition [ ] Correction [ ] Deprecation [ ] Cleanup (formatting, typos, etc.) ### Area [X] Installation instructions [ ] Configuration parameters [ ] Functionality/features [ ] REST API [ ] Administration/development [ ] Other <!-- Describe the proposed change(s). --> ### Proposed Changes The current CentOS installation instructions reference CentOS 7.5 and appear to be accurate for that OS version. CentOS 8.1 is different from 7.5, in that it includes a new package manager in `dnf`, it now ships with a supported version of PostgreSQL, which serves to simplify the installation overall, and some of the required packages have changed. I recently installed NetBox in a fresh CentOS 8.1 environment and updated the existing installation documentation as I proceed through the steps. I can submit a pull request, but wanted to make sure I had this documentation change issue written up first.
adam closed this issue 2025-12-29 18:30:00 +01:00
adam commented 2025-12-29 18:30:00 +01:00
Author
Owner
Copy Link

@jeremystretch commented on GitHub (Apr 20, 2020):

We don't have the resources to maintain more than one version of the installation documentation per distribution. (Frankly, we barely have the resources to support what we have already.) So the proposal here would be to replace the existing 7.5 documentation with 8.1.

I don't have a strong opinion either way, but I get the feeling 8.1 is probably still too new for many people. Leaving this open for debate.

@jeremystretch commented on GitHub (Apr 20, 2020): We don't have the resources to maintain more than one version of the installation documentation per distribution. (Frankly, we barely have the resources to support what we have already.) So the proposal here would be to _replace_ the existing 7.5 documentation with 8.1. I don't have a strong opinion either way, but I get the feeling 8.1 is probably still too new for many people. Leaving this open for debate.
adam commented 2025-12-29 18:30:01 +01:00
Author
Owner
Copy Link

@ariesgeek commented on GitHub (Apr 22, 2020):

Thank you for your time, Jeremy.

Very valid points! Judging by the sound of the crickets, I am going to assume that we'll stay with the status quo for the time being, but I will continue to maintain CentOS 8.1 documentation in a separate branch off of my fork and will make a little noise when it is looking like 8.x might be overtaking 7.5.

Not to be too presumptive, I won't close this issue right now, but will defer to the judgment of the maintainers as to how long this should remain open for feedback from the community.

@ariesgeek commented on GitHub (Apr 22, 2020): Thank you for your time, Jeremy. Very valid points! Judging by the sound of the crickets, I am going to assume that we'll stay with the status quo for the time being, but I will continue to maintain CentOS 8.1 documentation in a separate branch off of my fork and will make a little noise when it is looking like 8.x might be overtaking 7.5. Not to be too presumptive, I won't close this issue right now, but will defer to the judgment of the maintainers as to how long this should remain open for feedback from the community.
adam commented 2025-12-29 18:30:01 +01:00
Author
Owner
Copy Link

@chicks-net commented on GitHub (Apr 22, 2020):

Would it make sense to put this sort of stuff in the wiki so it doesn't convey the same level of maintenance while still letting useful contributions land somewhere?

@chicks-net commented on GitHub (Apr 22, 2020): Would it make sense to put this sort of stuff in the [wiki](https://github.com/netbox-community/netbox/wiki) so it doesn't convey the same level of maintenance while still letting useful contributions land somewhere?
adam commented 2025-12-29 18:30:01 +01:00
Author
Owner
Copy Link

@jeremystretch commented on GitHub (Apr 27, 2020):

@chicks-net No; all the documentation for which the core maintainers are responsible must reside within the git repository. We use the wiki to a limited extent for "meta" documentation about the project rather than the application itself.

@jeremystretch commented on GitHub (Apr 27, 2020): @chicks-net No; all the documentation for which the core maintainers are responsible must reside within the git repository. We use the wiki to a limited extent for "meta" documentation about the project rather than the application itself.
adam commented 2025-12-29 18:30:01 +01:00
Author
Owner
Copy Link

@chicks-net commented on GitHub (Apr 27, 2020):

We keep running into the core maintainers not wanting to maintain installation documentation for different distributions. I put the years it took to move from supervisor to systemd in the docs into the same category. But folks from the non-core community are showing and trying to help. This seems like the sort of thing that belongs in the wiki to me, but it doesn't sound meta-enough for you. I don't see the harm in this sort of thing being in the wiki, but I'm not in charge, so I defer to your expertise. And you're running a really tight ship so I do strongly believe in that expertise.

It sounds like the only clearly acceptable option would be for the community of non-core netbox developers to start a new project to maintain installation docs. I doubt that will happen, but maybe enough folks will step up.

Another possibility would be allowing for some folks to maintain docs, even if they're not good enough to be a core developer. Other FLOSS projects have had similar documentation subprojects. I'd be happy to help with this from writing docs to maintaining docs automation.

@chicks-net commented on GitHub (Apr 27, 2020): We keep running into the core maintainers not wanting to maintain installation documentation for different distributions. I put the years it took to move from supervisor to systemd in the docs into the same category. But folks from the non-core community are showing and trying to help. This seems like the sort of thing that belongs in the wiki to me, but it doesn't sound meta-enough for you. I don't see the harm in this sort of thing being in the wiki, but I'm not in charge, so I defer to your expertise. And you're running a really tight ship so I do strongly believe in that expertise. It sounds like the only clearly acceptable option would be for the community of non-core netbox developers to start a new project to maintain installation docs. I doubt that will happen, but maybe enough folks will step up. Another possibility would be allowing for some folks to maintain docs, even if they're not good enough to be a core developer. Other FLOSS projects have had similar documentation subprojects. I'd be happy to help with this from writing docs to maintaining docs automation.
adam commented 2025-12-29 18:30:01 +01:00
Author
Owner
Copy Link

@jeremystretch commented on GitHub (Apr 27, 2020):

This seems like the sort of thing that belongs in the wiki to me, but it doesn't sound meta-enough for you.

It's not meta at all. These are the instructions we're providing for users to install NetBox. We can't tell someone, "if you have CentOS 7.5 go to RTD, but for 8.1 go over here to the wiki, but only for certain parts." That doesn't make any sense.

Additionally, we have and continue to accept pull requests for documentation; there is no need for a formal role. However, it needs to be maintainable so that when the PR author disappears someone else can continue the work.

@jeremystretch commented on GitHub (Apr 27, 2020): > This seems like the sort of thing that belongs in the wiki to me, but it doesn't sound meta-enough for you. It's not meta at all. These are the instructions we're providing for users to install NetBox. We can't tell someone, "if you have CentOS 7.5 go to RTD, but for 8.1 go over here to the wiki, but only for certain parts." That doesn't make any sense. Additionally, we have and continue to accept pull requests for documentation; there is no need for a formal role. However, it needs to be maintainable so that when the PR author disappears someone else can continue the work.
adam commented 2025-12-29 18:30:01 +01:00
Author
Owner
Copy Link

@jeremystretch commented on GitHub (Apr 29, 2020):

It doesn't seem like there's a strong demand for updating the installation docs for CentOS to 8.1 at this time. We can revisit in the future.

@jeremystretch commented on GitHub (Apr 29, 2020): It doesn't seem like there's a strong demand for updating the installation docs for CentOS to 8.1 at this time. We can revisit in the future.
adam commented 2025-12-29 18:30:01 +01:00
Author
Owner
Copy Link

@ariesgeek commented on GitHub (Apr 29, 2020):

It doesn't seem like there's a strong demand for updating the installation docs for CentOS to 8.1 at this time. We can revisit in the future.

Sounds good. Feel free to reach out to me if and when. I also lurk on the NTC slack.

@ariesgeek commented on GitHub (Apr 29, 2020): > It doesn't seem like there's a strong demand for updating the installation docs for CentOS to 8.1 at this time. We can revisit in the future. Sounds good. Feel free to reach out to me if and when. I also lurk on the NTC slack.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
beta
breaking change
complexity: high
complexity: low
complexity: medium
needs milestone
netbox
pending closure
plugin candidate
pull-request
Mirrored from GitHub Pull Request
 severity: high
severity: low
severity: medium
status: accepted
status: backlog
status: blocked
status: duplicate
status: needs owner
status: needs triage
status: revisions needed
status: under review
topic: GraphQL
topic: Internationalization
topic: OpenAPI
topic: UI/UX
topic: cabling
topic: event rules
topic: htmx navigation
topic: industrialization
topic: migrations
topic: plugins
topic: scripts
topic: templating
topic: testing
type: bug
type: deprecation
type: documentation
type: feature
type: housekeeping
type: translation
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
adam
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/netbox#3584
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?