Getting Started


If you bought a pre-assembled upribox from our online store you can skip the getting started guide since everything is already set up and you only have to complete the simple tasks described in the enclosed manual. Go straight to

In a few easy steps you can build your own upribox and won’t get bothered anymore by annoying ads and trackers (see Silent Mode). Additionally you can use your upribox to surf the web anonymously via Tor (see Ninja Mode) and set it up to be your OpenVPN server which secures your connection in unprotected WiFis and lets you benefit from the ad-blocking features on the road (see VPN Server).


You can download the latest upribox image from Github and verify its integrity and authenticity with the provided signature file and PGP key (see Signed Releases). See the official Raspberry Pi documentation for pointers on how to install the upribox image on the SD card. Upon the first boot the SSH/VPN keys are automatically re-generated (this will take a couple of minutes).

Hardware requirements

In the following you will find a list of required (and tested) hardware for the upribox software.

Web Interface

Once you are connected to the upribox WiFi network you can access the upribox web interface via one of the following URIs:

In case your device is not connected to the upribox WiFi network and the traffic is not routed through the upribox, you can still access the web interface via:

(see Modes)

Default passwords

If you used the latest community upribox image for setting up your own privacy box you need the following passwords for accessing it:

Login User Default Password
Wifi (SSID: upribox) - changeme
Web Interface / SSH upri changethedefaults!

It is important that you change the passwords upon the first login in the admin section of the web interface. New passwords should have at least 8 characters containing lower-case, upper-case, numbers and special characters.

If you bought a pre-assembled upribox from our online store, the SSH password of your upribox is configured to be the equal to your webinterface password.


The upribox performs an auto-update every hour, which includes software updates via ansible and updates from github. The blocking rules for privoxy and DNS are updated every four hours.

Please note that this process overwrites manual changes to configuration files. To conduct persistent manual changes you have to use custom facts (see Customization).