platformio package publish

New in version 4.4.


pio package publish [<source directory, tar.gz or zip>] [OPTIONS]
platformio package publish [<source directory, tar.gz or zip>] [OPTIONS]


Publish a package to the registry so that it can be installed by name. All files in the package directory are included if export field is not declared in a package manifest (for example, see export). The next items are automatically excluded:

  • ._*
  • __*
  • .DS_Store
  • .git/
  • .hg/
  • .svn/
  • .pio/
  • **/.pio/

Please check which files will be included in the final package using the platformio package pack command.

Once a package is published with a given name and version, that specific name and version combination can never be used again, even if it is removed with the platformio package unpublish command.

If no arguments are supplied, then PlatformIO packs the current package folder.



PIO Account username (can be organization username). The default is set to a username of the authorized PIO Account.


Custom release date and time in the next format (UTC): 2014-06-13 17:08:52


Restrict access to a package (will not be available publicly). The default is to publish a package publicly.


Do not notify by email when package is processed. The default behavior is to notify.