This document discusses upgrading a PostgreSQL database from a major version to another using logical replication. It begins with an introduction to logical replication and its advantages over other upgrade methods. It then covers the architecture of logical replication, including how the walsender reads WAL files and applies changes to the subscriber. Finally, it addresses some limitations of logical replication for upgrades, such as objects that are not replicated, and provides strategies for completing the upgrade while minimizing downtime.