The recommended install procedure has been changed. We now recommend to use docker to deploy BrewPi. You can read how on our wiki at https://wiki.brewpi.com.
So you got your Raspberry Pi, BrewPi Spark and peripherals. Now it is time to install the software.
This guide will take you through the install and configuration process step by step.
The Raspberry Pi comes with an SD card pre-loaded with NOOBS, which let's you select an operating system to install.
Take the small SD card out of the big SD card and put in the Raspberry Pi.
Then connect a micro USB power supply, a keyboard and a HDMI monitor or TV. The monitor and keyboard a temporary, just to get though the install process.
You will be presented with this screen:
Select Raspbian, the first option with the spacebar. With L and 9, select your preferred language and keyboard layout. I prefer English (US), even though I am Dutch. Using English as system language will make it easier to find help if you encounter problems. Finally, press i to start the install.
The install will take about 20 minutes to complete. Press enter to reboot when you see this screen:
When the pi has fully rebooted, it will show a configuration menu. You can also manually start it by running
Expanding the file system has already been done if you installed from a NOOBS SD card.
Change the password for better security. The default password for the
pi user is
Under option 4, change the time zone to your location. This will give you the correct local time.
Click 'Finish' to complete the setup.
Now let's configure the network settings.
By default, the Raspberry Pi automatically gets an IP address via DHCP.
It also has zeroconf/bonjour installed which will announce the Raspberry Pi on the local network to make it available as http://raspberrypi.local.
If zeroconf is not installed, you can install it with
sudo apt-get install avahi-daemon
Under advanced settings in
raspi-config, you can change the hostname. The zeroconf address is http://hostname.local and raspberrypi is the default hostname. So if you do not change the hostname, the address is http://raspberrypi.local
If you do not which to use ZeroConf, it is recommended to give your Raspberry Pi a static IP address. This step is optional. You can skip to SSH if you want to keep the automatically assigned address.
To set up a static address run:
sudo nano /etc/network/interfaces
My /etc/network/interfaces file looks like this:
iface lo inet loopback
iface eth0 inet dhcp
iface wlan0 inet static
It is recommended to pick a static Ip address that is outside of your router’s DHCP range. (usually .100-.200)
The right IP addresses depend on your home network setup. I have used Google's public DNS server.
Exit nano with CTRL-X and say YES to saving changes.
Finally, you will need to restart the networking service for these changes to occur:
sudo service networking stop
sudo service networking start
Check that you now have network connectivity by pinging google:
Exit with CTRL-C.
Now that you have network, we can do the rest of the setup over SSH, so you can easily copy/paste commands.
Logging in via SSH
For Windows users, install Putty. Mac and Linux users can just type
ssh email@example.com (or whatever your IP address is). You can also use your Zeroconf address (defautl
raspberrypi.local) instead of the IP.
In Putty, fill in your IP, leave port at 22 and press 'Open'. Log in as user
pi, which your previously chosen password or the default password
Now let's first make sure that our Raspberry Pi is up-to-date. Upgrade all programs by running:
sudo apt-get update
sudo apt-get upgrade
Finally, let's also update the pi's firmware, with rpi-update:
Reboot after the firmware update is done (
sudo reboot), wait until they pi has booted and connect with ssh again (right mouse on putty, restart session)
Installing BrewPi is very easy with our install script. The only 2 commands you need to run are to get the install script:
sudo apt-get install git
git clone https://github.com/BrewPi/brewpi-tools.git ~/brewpi-tools
And to run the install script:
If you want to update your BrewPi later, you can run:
(currently writing this)