Installing PiNet

Warning - PiNet should be installed onto a fresh Ubuntu 18.04 installation. Do not install PiNet onto an Ubuntu installation running other services as PiNet can not be easily uninstalled.

Now you have an Ubuntu 18.04 server setup, it is time to actually install PiNet. PiNet is run through a terminal. This allows you use it locally or even run the software over SSH! Lets get started!

  1. Once the machine reboots, login with your credentials you set up earlier.

  2. Select the search button in the top left corner.

  3. Search for and select “Terminal”. You can also just hit Ctrl + Alt + T.

  4. You will then be presented with a terminal. PiNet runs inside a terminal window. You may find it useful to resize the terminal window to make it larger or put it in full screen.

  5. To install PiNet Jessie (Stable), enter wget --content-disposition and hit enter. This downloads the PiNet script. The main script is called pinet.

    PiNet Jessie - Note that PiNet Jessie is now recommended over PiNet Wheezy (version 1.1.9 and below). PiNet Wheezy support will end at the end of 2017.

    For details over other PiNet versions, see here.

  6. Once that completes, enter sudo bash pinet which will launch PiNet. A desktop icon will be created when the software installs but you can always use this command to manually launch PiNet.

  7. Enter your password as the application must be run as administrator (nothing will look like it is being entered, this is a Linux security feature so don’t worry, it is being entered).

  8. PiNet will offer to run a full install, select yes.

  9. PiNet supports importing user data from an older PiNet server. See the migration guide for details. Select No.

Note - PiNet Jessie right now only includes support for the Raspberry Pi 3 B+ in the Alpha and Beta branches. If you wish to use PiNet with a 3B+, please make sure you are on the Alpha or Beta branch.
  1. Select which release channel you wish to use. If using in a production environment, it is recommended you select Stable. If you wish to test out new bleeding edge features, select Development.

  2. Select Ok to continue after reading how to select additional software.

  3. Select any extra software you wish to include.
    ( Screenshot shows several non-default selections)

  4. If extra software specified, select Yes to confirm

  5. If extra software ‘Custom-package’ selected, enter package name.

  6. If extra software ‘Custom-python’ selected, enter package name.

  7. The install will take roughly 1-2 hours depending on processor speed and internet speed. Select ok and it will start the installation. You can now leave it to work.

  8. After 1-2 hours, select choice whether to give students Sudo access on the Raspberry Pi. If you intend to work with the GPIO pins on the Raspberry Pi they will need it. You can really easily later enable or disable Sudo use in the Manage-Users submenu in the main software options. If in doubt, is recommended to enable it by selecting yes.

  9. If using 2 network interface cards then check the IP address is correct. If you are only using 1 (most people), then the default will likely be correct. Select yes.

  10. Select OK after reading notice about collected statistics.

  11. Select OK after reading notice about additional information.

  12. (Optional) Select OK after entering nearest major city.

  13. (Optional) Select OK after entering organisation type.

  14. (Optional) Select OK after entering school/organisation name.

  15. Select OK after reading how to edit additional information.

  16. The operating system will now be compressed. After every change made to the operating system, it must be recompressed which takes roughly 5 minutes normally. Select ok.

  17. PiNet installation is now complete. The server has generated an SD card image which is located in /home/YourUser/piboot. You need to copy these files onto a blank formatted SD card and connect the Raspberry Pi to the network.

  18. You are recommended to check the Backup section of this manual on setting up an automatic backup of your students work to an external hard drive in case of hard drive failure.

Copying to SD card

Now that you have installed PiNet, you need to copy the boot files to an SD card.