Getting started with PiNet

What is PiNet?

PiNet is a free and open source project for helping schools set up and manage a Raspberry Pi classroom.
It has been developed alongside teachers with feedback from over 15 countries across the world.
Its key features include

  • Network based user accounts - Any student can sit down at any Raspberry Pi and log in.
  • Network based operating system - All Raspberry Pis boot a single master Raspbian operating system.
  • Shared folders - Easy to use shared folder system for teachers and students.
  • Work collection system - Simple work collection/submission system to allow students to hand in work.
  • Automated backups - Automatically backup all students work to an external drive periodically.
  • Many more small features like batch user import, classroom management software integration etc.

The server software is installed on a computer running Ubuntu Linux 18.04 (recommended). Ubuntu is completely free. You must then connect the server and Raspberry Pis together by using a wired network.

Note Wifi is not supported - More information on WiFi here

I am interested, what do I need to get started?

First you need to grab the required equipment. Full details of this can be found on the hardware page.

  • A network switch (with at least a single gigabit or 10/100/1000mbit port for the server).
  • A router (only if building a standalone network).
  • Some ethernet cables to link it all up together.
  • A supported Raspberry Pi with an SD card (or micro SD card) of at least 128MB in size.
  • A computer to use for the PiNet server. For this, you have 2 options…

Dedicated computer for the PiNet server

PiNet can run on an old desktop/laptop you may have sitting around. Just make sure it adheres to the minimum specs required for PiNet.

Virtual machine running on another Windows/Mac/Linux computer for the PiNet server

Not got an old machine you can dedicate to PiNet? No problem, PiNet can run in an isolated virtual machine on another computer running Windows, Mac OS or Linux. This method comes with a number of advantages including

  • It is easy to delete or start again as PiNet/Ubuntu are stored in a single file on the computer.
  • Given the PiNet/Ubuntu server is a single file, it can be easily moved to a different computer later down the line.
  • Allows for virtual machine snapshots to be used, allowing the server to be easily reverted to an older saved copy.

There are some disadvantages though

  • A computer with decent performance is required (see hardware page for minimum/recommended hardware required).
  • When running the PiNet server, other software running on the computer may feel slower as it is running 2 complete operating systems.
  • Additional hard disk space is required (recommended 40GB for PiNet) as the computer holds a full copy of Windows/Mac OS/Linux as well as PiNet/Ubuntu.

If you have a powerful enough computer, creating a virtual PiNet server is a great way to try PiNet out without much upfront investment. There are a number of different software platforms for creating/running virtual machines including Hyper-V (Windows only and commercial), VMWare (cross platform and commercial) or VirtualBox (cross platform and open source).
The recommended platform for setting up a PiNet server is VirtualBox given it is completely free and open source.

Want to try out PiNet with VirtualBox? - For more info on Virtualbox setup with PiNet, check the Virtualbox install guide.


Once you have the needed equipment, you will need to install Ubuntu 18.04 onto your server computer and then install PiNet.
Overall this takes roughly 2-3 hours. Of that 2-3 hours, you are required at the computer for 20-30 minutes.
Finally when the installation is complete you must copy the generated SD card boot files to a blank SD card.
If your school or organisation uses any form of web filtering or a proxy to access the internet, make sure to first read the web filtering information page.

  1. Installing Ubuntu server
  2. Installing PiNet
  3. Copying files to SD card

Once completed, you may want to play with some of the other options in PiNet, the full documentation list can be found back on the guides page.

Currently running Raspi-LTSP? - Raspi-LTSP is now no longer supported, check out the user migration guide for details on how to upgrade to PiNet.