pio-upgrade

Update PlatformIO to the latest version

$ pio upgrade

$ pio upgrade --dev

pio upgrade

The `pio upgrade` command updates the PlatformIO Core to the latest available version. PlatformIO Core is the command-line tool that is used to build, upload, and manage PlatformIO projects. It's essential to keep the Core updated to benefit from the latest features, bug fixes, and security patches. This command ensures that you are running the most current and stable version of the PlatformIO ecosystem.

The upgrade process typically involves downloading and installing the newest packages and dependencies. It's generally a safe operation, but it's recommended to back up your project configuration and dependencies before proceeding, especially if you're using a complex or customized setup. Following an upgrade, it may be necessary to restart the PlatformIO IDE extension or shell environment to ensure that the changes are fully applied.

The upgrade process requires an active internet connection. In some cases, especially after major upgrades, you might need to manually restart your IDE or shell environment for the changes to take full effect. Ensure that PlatformIO Core is properly installed and configured before attempting an upgrade. Check the PlatformIO documentation for troubleshooting steps if you encounter issues during the upgrade process.

When you run `pio upgrade`, PlatformIO checks for a newer version of the core. If a newer version is available, it downloads and installs it. The command provides progress information in the console, so you can monitor the status. After the upgrade is finished, it's often advised to restart your IDE to apply the updates correctly.

The `pio upgrade` command has been a core part of the PlatformIO CLI since its inception. It allows users to easily keep their PlatformIO environment up-to-date. The development and usage have evolved as PlatformIO added new features and refined its dependency management.

pio update(1), pio system info(1)