Skip to content

Improve Docker Documentation and Add Reference to openupgrade-docker #5495

@ikus060

Description

@ikus060

Description

Currently, OpenUpgrade provides excellent migration scripts but lacks comprehensive documentation for running upgrades in Docker environments. Users need significant technical knowledge to piece together all the required steps for a successful database upgrade using Docker.

Problem Statement

  • The Docker upgrade process is not well documented in OpenUpgrade
  • Users need to understand multiple technical concepts simultaneously
  • No streamlined "batteries-included" approach exists for Docker users
  • This creates a barrier to entry for users who want to upgrade their Dockerized Odoo instances

Proposed Solution

I've created openupgrade-docker to address this gap. The project provides:

  • Pre-built Docker images with all necessary components for running migrations
  • Simplified workflow to make the upgrade process "dummy proof"
  • Step-by-step guides that don't require deep migration expertise

Request

Would the OCA/OpenUpgrade project consider:

  1. Adding a reference to openupgrade-docker in the main README under a "Docker" section
  2. Linking to the project in the official documentation
  3. Potentially collaborating on best practices for Docker-based upgrades

Benefits

  • Lower barrier to entry for new users
  • Better visibility for Docker-specific upgrade workflows
  • Centralized resource for the community
  • Reduced support burden from common Docker-related questions

Contribution

I'm willing to:

  • Maintain the openupgrade-docker project
  • Submit a PR to update OpenUpgrade documentation
  • Collaborate on Docker best practices
  • Help other users with Docker-specific issues

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions