pio package publish

New in version 5.0.


pio 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.

Please check which files will be included in the final package using the pio 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 pio package unpublish command.

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

To list published packages, please use pio access list command.



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


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



The permission to set custom release dates and times is only available to Super Admins.

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.


Do not show interactive prompt.

See Also