From 0ac9f5c1742aad1822be899e72ed5bddb876771d Mon Sep 17 00:00:00 2001 From: Jeremy Stretch Date: Thu, 7 May 2026 08:38:26 -0400 Subject: [PATCH] Raise minimum required PostgreSQL version from 14 to 15 (closes #20546) PostgreSQL 14 reaches end-of-life in November 2026 and Django 6.1 will require PostgreSQL 15+. Updates all documentation references from 14 to 15, and removes the "needed on PostgreSQL 15 and later" conditional comment from the database creation instructions (since 15 is now the minimum). Co-Authored-By: Claude Sonnet 4.6 --- docs/configuration/required-parameters.md | 2 +- docs/installation/1-postgresql.md | 7 +++---- docs/installation/index.md | 2 +- docs/installation/upgrading.md | 2 +- docs/introduction.md | 2 +- docs/release-notes/version-4.7.md | 15 +++++++++++++++ 6 files changed, 22 insertions(+), 8 deletions(-) create mode 100644 docs/release-notes/version-4.7.md diff --git a/docs/configuration/required-parameters.md b/docs/configuration/required-parameters.md index 72573afad..2255ff462 100644 --- a/docs/configuration/required-parameters.md +++ b/docs/configuration/required-parameters.md @@ -59,7 +59,7 @@ See the [`DATABASES`](#databases) configuration below for usage. ## DATABASES -NetBox requires access to a PostgreSQL 14 or later database service to store data. This service can run locally on the NetBox server or on a remote system. Databases are defined as named dictionaries: +NetBox requires access to a PostgreSQL 15 or later database service to store data. This service can run locally on the NetBox server or on a remote system. Databases are defined as named dictionaries: ```python DATABASES = { diff --git a/docs/installation/1-postgresql.md b/docs/installation/1-postgresql.md index 41751fc10..7dac7cf46 100644 --- a/docs/installation/1-postgresql.md +++ b/docs/installation/1-postgresql.md @@ -2,8 +2,8 @@ This section entails the installation and configuration of a local PostgreSQL database. If you already have a PostgreSQL database service in place, skip to [the next section](2-redis.md). -!!! warning "PostgreSQL 14 or later required" - NetBox requires PostgreSQL 14 or later. Please note that MySQL and other relational databases are **not** supported. +!!! warning "PostgreSQL 15 or later required" + NetBox requires PostgreSQL 15 or later. Please note that MySQL and other relational databases are **not** supported. ## Installation @@ -12,7 +12,7 @@ sudo apt update sudo apt install -y postgresql ``` -Before continuing, verify that you have installed PostgreSQL 14 or later: +Before continuing, verify that you have installed PostgreSQL 15 or later: ```no-highlight psql -V @@ -32,7 +32,6 @@ Within the shell, enter the following commands to create the database and user ( CREATE DATABASE netbox; CREATE USER netbox WITH PASSWORD 'J5brHrAXFLQSif0K'; ALTER DATABASE netbox OWNER TO netbox; --- the next two commands are needed on PostgreSQL 15 and later \connect netbox; GRANT CREATE ON SCHEMA public TO netbox; ``` diff --git a/docs/installation/index.md b/docs/installation/index.md index 7ef8dd0d4..b514df448 100644 --- a/docs/installation/index.md +++ b/docs/installation/index.md @@ -28,7 +28,7 @@ The following sections detail how to set up a new instance of NetBox: | Dependency | Supported Versions | |------------|--------------------| | Python | 3.12, 3.13, 3.14 | -| PostgreSQL | 14+ | +| PostgreSQL | 15+ | | Redis | 4.0+ | Below is a simplified overview of the NetBox application stack for reference: diff --git a/docs/installation/upgrading.md b/docs/installation/upgrading.md index 5110def57..e6c60c80c 100644 --- a/docs/installation/upgrading.md +++ b/docs/installation/upgrading.md @@ -20,7 +20,7 @@ NetBox requires the following dependencies: | Dependency | Supported Versions | |------------|--------------------| | Python | 3.12, 3.13, 3.14 | -| PostgreSQL | 14+ | +| PostgreSQL | 15+ | | Redis | 4.0+ | ### Version History diff --git a/docs/introduction.md b/docs/introduction.md index c8e5ee8ac..1b7cf5316 100644 --- a/docs/introduction.md +++ b/docs/introduction.md @@ -79,5 +79,5 @@ NetBox is built on the [Django](https://djangoproject.com/) Python framework and | HTTP service | nginx or Apache | | WSGI service | gunicorn or uWSGI | | Application | Django/Python | -| Database | PostgreSQL 14+ | +| Database | PostgreSQL 15+ | | Task queuing | Redis/django-rq | diff --git a/docs/release-notes/version-4.7.md b/docs/release-notes/version-4.7.md new file mode 100644 index 000000000..76931f7a1 --- /dev/null +++ b/docs/release-notes/version-4.7.md @@ -0,0 +1,15 @@ +# NetBox v4.7 + +## v4.7.0 (FUTURE) + +### Breaking Changes + +* The minimum required PostgreSQL version has been raised from 14 to 15. + +### Enhancements + +### Other Changes + +* [#20546](https://github.com/netbox-community/netbox/issues/20546) - Raise the minimum required PostgreSQL version from 14 to 15 + +### REST API Changes