{"id":270,"date":"2020-11-19T09:16:35","date_gmt":"2020-11-19T09:16:35","guid":{"rendered":"https:\/\/picockpit.com\/raspberry-pi\/?page_id=270"},"modified":"2024-03-11T12:02:13","modified_gmt":"2024-03-11T12:02:13","slug":"installation-of-picockpit","status":"publish","type":"page","link":"https:\/\/picockpit.com\/raspberry-pi\/installation-of-picockpit\/","title":{"rendered":"How to Install PiCockpit"},"content":{"rendered":"\n
\"How<\/figure>\n\n\n\n

This page will show you how to install PiCockpit.<\/p>\n\n\n\n

At the moment, there are two ways to install the PiCockpit Client. One way is without an API key. The other way is with an API key.<\/p>\n\n\n\n

Installation without an API Key<\/h2>\n\n\n\n

To install the PiCockpit Client through our web interface, you first need to create a PiCockpit account<\/a>.<\/p>\n\n\n\n

Once you’ve created an account, you should click on the button that says “ADD NEW PI”.<\/p>\n\n\n\n

<\/p>\n\n\n

\n
\"Add<\/figure>\n<\/div>\n\n\n

This will download a script to your Downloads folder.<\/p>\n\n\n\n

If you’ve downloaded this onto your Raspberry Pi, then all you need to do is make it executable. You can open up your command line and run:<\/p>\n\n\n\n

<\/p>\n\n\n\n

<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
cd<\/span> <\/span>Downloads<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Now you’re in the Downloads repository. From here, run:<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
chmod<\/span> <\/span>+<\/span>x<\/span> <\/span>picockpit<\/span>-<\/span>addrpi<\/span>-<\/span>v2<\/span>.<\/span>5.0<\/span>.<\/span>sh<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
And finally, run the script:<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
.<\/span>\/<\/span>picockpit<\/span>-<\/span>addrpi<\/span>-<\/span>v2<\/span>.<\/span>5.0<\/span>.<\/span>sh<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
That will run the script on the Raspberry Pi. <\/p>\n\n\n\n
If it asks you if you want to continue, simply type “y”. <\/p>\n\n\n\n
If you’ve downloaded the script onto another computer and want to ssh<\/code> into your Raspberry Pi, then you first need to copy the file over to the Raspberry Pi. You can do that with this command:<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
scp<\/span> <\/span>\/<\/span>home<\/span>\/<<\/span>name<\/span>>\/<\/span>Downloads<\/span>\/<\/span>picockpit<\/span>-<\/span>addrpi<\/span>-<\/span>v2<\/span>.<\/span>5.0<\/span>.<\/span>sh<\/span> <\/span><<\/span>your<\/span>-<\/span>name<\/span>><\/span>@<\/span><<\/span>raspberrypi<\/span>-<\/span>name<\/span>><\/span>.<\/span>local<\/span>:<\/span>\/<\/span>home<\/span>\/<\/span><<\/span>name<\/span>>\/<\/span>Downloads<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Please ensure that in the script above, you replace each instance of <name><\/code> with the correct username and Raspberry Pi name. Once you’ve done that and run the script, it will ask you to type in your password for the Raspberry Pi.<\/p>\n\n\n\n
After you’ve successfully copied over the file, you can then ssh<\/code> into your Raspberry Pi and follow the commands above. <\/p>\n\n\n\n
Installation with an API Key<\/h2>\n\n\n\n
After creating a PiCockpit account<\/a>, you need to go to your user profile page. Simply click on your name at the top right and it will take you to this screen:<\/p>\n\n\n\n
<\/p>\n\n\n
\n
\"Manage<\/figure>\n<\/div>\n\n\n
<\/p>\n\n\n\n
Click on the button hat says “MANAGE API KEYS”. <\/p>\n\n\n\n
You’ll then need to click on the button that says “ADD API-KEY”:<\/p>\n\n\n\n
<\/p>\n\n\n
\n
\"ADD<\/figure>\n<\/div>\n\n\n
<\/p>\n\n\n\n
This will create a single API key that you’ll want to save like a password.<\/p>\n\n\n\n
It will only show you your API key once. So be sure to save it in a secure location.<\/strong><\/p>\n\n\n\n
Please note API keys are case-sensitive and the “.” is also required.<\/p>\n\n\n\n
Also note that one API key can be used for several Raspberry Pis. There is no need to create a new API key every time you add a new Raspberry Pi. However, you are free to create multiple API keys if you would like.<\/p>\n\n\n\n
After saving your API key in a secure place, you can run the following one-line installation (on the Raspberry Pi):<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
bash<\/span> <\/span>-<\/span>c<\/span> <\/span>"<\/span>$(curl -k -s https:\/\/picockpit.com\/setup.sh)<\/span>"<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Press enter when asked whether you want to proceed with the package installation. Also have your API key handy, as the installer will ask you for it.<\/p>\n\n\n\n
The installer will acknowledge a successful installation and connection with PiCockpit.com.<\/p>\n\n\n\n
FAQ<\/h2>\n\n\n\n
Where <\/strong>can I find detailed installation instructions?<\/h3>\n\n\n\n
If you’re curious what the one-liner above does, and would like to run the installation manually, please have a look at these manual installation instructions<\/a>.<\/p>\n\n\n\n
The PiCockpit Client needs to be installed only once, it will automatically start on every boot.<\/p>\n\n\n\n
Please refer to the documentation<\/a> for an overview of what you can do with PiCockpit. <\/p>\n\n\n\n
Will PiCockpit work on a 32-Bit and 64-Bit operating system?<\/h3>\n\n\n\n
Picockpit runs on both 32-Bit and 64-Bit versions of Raspberry Pi OS.<\/p>\n\n\n\n
Is PiCockpit compatible with Ubuntu or Fedora?<\/h3>\n\n\n\n
We have developed PiCockpit specifically for Raspberry Pi OS, for both stability and security reasons. So we currently only offer official support for PiCockpit on Raspberry Pi OS.<\/p>\n\n\n\n
How can I start, stop, enable, and disable PiCockpit on the command line?<\/h3>\n\n\n\n
PiCockpit is integrated with Systemd. If you prefer to manually manage PiCockpit through the command line (although it’s not recommended), you can use the following commands to start, stop, enable, and disable the client:<\/p>\n\n\n\n
Start:<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>systemctl<\/span> <\/span>start<\/span> <\/span>picockpit<\/span>-<\/span>client<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Stop:<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>systemctl<\/span> <\/span>stop<\/span> <\/span>picockpit<\/span>-<\/span>client<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Enable (which autostarts the PiCockpit Client upon reboot):<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>systemctl<\/span> <\/span>enable<\/span> <\/span>picockpit<\/span>-<\/span>client<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Disable (which prevents the PiCockpit Client from autostarting upon reboot):<\/p>\n\n\n\n
<\/p>\n\n\n\n
<\/circle><\/circle><\/circle><\/g><\/svg><\/span><\/path><\/path><\/svg><\/span>
sudo<\/span> <\/span>systemctl<\/span> <\/span>disable<\/span> <\/span>picockpit<\/span>-<\/span>client<\/span><\/span><\/code><\/pre><\/div>\n\n\n\n
<\/p>\n\n\n\n
Please note that it’s generally recommended to use PiCockpit through its intended interface rather than directly via the command line for a more user-friendly experience.<\/p>\n\n\n\n
How can I uninstall PiCockpit from my Raspberry Pi?<\/h3>\n\n\n\n
We also have a help page for you detailing how to remove PiCockpit<\/a>.<\/p>\n
Refresh the My Raspberry Pis<\/a> page in your browser, and you’ll be able to see the new Raspberry Pi.<\/p>\n\n\n\n
Once it’s installed, your Raspberry Pi will automatically appear on the My Raspberry Pis page<\/a>. You may have to reload the page to ensure that it connects.<\/p>\n\n\n\n