Install Shell Commands¶
PlatformIO Core (CLI) consists of 2 standalone tools in a system:
If you have PlatformIO IDE already installed, you do not need to install PlatformIO Core (CLI) separately. Just link these tools with your shell:
Unix and Unix-like¶
In Unix and Unix-like systems, you can create symbolic links (symlinks)
$HOME/.local/bin/ directory to the necessary PlatformIO executables.
This will allow you to execute
platformio commands from any terminal emulator
as long as you’re logged in as the user PlatformIO is installed and configured for.
First, if it’s not already the case, you should export your
directory to the PATH environmental variable. If you use Bash as your default shell,
you can do it by editing either
~/.bash_profile and adding the
If you use Zsh, you can either edit
~/.zprofile and add the code above, or
for supporting both, Bash and Zsh, you can first edit
~/.profile and add
the code above, then edit
~/.zprofile and add the following line:
emulate sh -c '. ~/.profile'
If you don’t know the difference between the two, check out this page.
Now that is done, or if
$HOME/.local/bin/ was already exported to your PATH environmental
variable, you can create the symlinks by opening your system terminal app and paste these
ln -s ~/.platformio/penv/bin/platformio ~/.local/bin/platformio ln -s ~/.platformio/penv/bin/pio ~/.local/bin/pio ln -s ~/.platformio/penv/bin/piodebuggdb ~/.local/bin/piodebuggdb
After everything’s done, just restart your session (log out and log back in) and you’re good to go.
You can create system-wide symlinks. This method is not recommended if you have
multiple users on your computer because the symlinks will be broken for other users
and they will get errors while executing PlatformIO commands. If that’s not a problem,
open your system terminal app and paste these commands.
(PROBABLY requires administrator access
mkdir -p /usr/local/bin ln -s ~/.platformio/penv/bin/platformio /usr/local/bin/platformio ln -s ~/.platformio/penv/bin/pio /usr/local/bin/pio ln -s ~/.platformio/penv/bin/piodebuggdb /usr/local/bin/piodebuggdb
After that, you should be able to run PlatformIO from terminal. No restart is required.
Please read one of these instructions How do I set or change the PATH system variable?
You need to edit the system environment variable called
Path and append
C:\Users\UserName\.platformio\penv\Scripts; path in the beginning of a
list (please replace
UserName with your account name).