Skip to content

docs: add PostgreSQL v16 to v18 migration guide for v7.0.0#51

Merged
mlodic merged 2 commits intointelowlproject:mainfrom
NikhilRaikwar:upgrade/postgres-18-v7
Feb 9, 2026
Merged

docs: add PostgreSQL v16 to v18 migration guide for v7.0.0#51
mlodic merged 2 commits intointelowlproject:mainfrom
NikhilRaikwar:upgrade/postgres-18-v7

Conversation

@NikhilRaikwar
Copy link
Copy Markdown
Contributor

Add PostgreSQL v16 to v18 migration guide for v7.0.0. Closes intelowlproject/IntelOwl#3272

Description

This PR adds a comprehensive 12-step migration guide for users upgrading from IntelOwl v6.x.x (PostgreSQL 16) to v7.0.0 (PostgreSQL 18).

The guide walks users through:

  • Dumping data from the legacy container.
  • Setting up a temporary environment for the restore.
  • Safely transitioning to the new postgres_data_v18 volume.

Related IntelOwl PR: intelowlproject/IntelOwl#3292

Checklist

  • The pull request is for the branch main
  • If I added new documentation related to a new Pull Request that I created, I have added a reference to the related Pull Request
    • If the new documentation will be added in a future release, please add a reference like _Available from version > 6.0.0_ (This documentation is for v7.0.0)
  • If the additional documentation is a fix, you should directly push to the main branch and do not open this PR. (This is a new migration guide, so a PR is appropriate).

Comment thread docs/IntelOwl/installation.md Outdated
docker container rm intelowl_postgres_16
```
7. (Optional) Remove the old PostgreSQL volume:
```bash
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

note here what would the consequence (removing the backup)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

also, this is better to put at the end, after having checked everything works properly

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Added a explicit warning about the consequence of removing the old volume (permanent deletion of the backup).
  • Reordered the steps to move the old volume removal to the very end of the process.

Below you can find the additional process required to upgrade from each major versions.
</div>

#### Updating to >=7.0.0 from a 6.x.x version
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please add note that the 7.0.0 version does not exist yet, we will remove it later

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a note clarifying that v7.0.0 is not yet officially released.

@NikhilRaikwar
Copy link
Copy Markdown
Contributor Author

Hi @mlodic,

I've updated the documentation guide to address your feedback:

  • Added a note clarifying that v7.0.0 is not yet officially released.
  • Reordered the steps to move the old volume removal to the very end of the process.
  • Added a explicit warning about the consequence of removing the old volume (permanent deletion of the backup).

@mlodic mlodic merged commit 92aad73 into intelowlproject:main Feb 9, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

upgrade postgres local container from 16 to 20 (or more recent)

2 participants