diff --git a/HOWTO.md b/HOWTO.md
new file mode 100644
index 0000000..55e37d4
--- /dev/null
+++ b/HOWTO.md
@@ -0,0 +1,174 @@
+# Setup Pizzabox
+
+## Materials:
+
+- Raspberry Pi 3B+ with [Pimoroni On/Off SHIM](https://shop.pimoroni.com/products/onoff-shim)
+
+- Raspberry Pi OS Lite 2021-05-07
+
+- *(later)* Raspberry Pi Pico, connected via UART and power
+
+- USB Soundcard
+
+## Resources:
+
+- [official raspberry pi](https://www.raspberrypi.org/documentation/usage/gpio/)
+
+- [interactive pinout documentation](https://pinout.xyz/pinout/onoff_shim#)
+
+## Initial Configuration:
+
+### Before First Boot
+
+- Enable ssh:
+
+        cd <media/user>/boot
+        touch ssh
+        
+- Set fixed fallback ip on eth0:
+
+        cd <media/user>/rootfs/etc
+        sudo nano dhcpcd.conf
+        
+  Uncomment the following lines:
+  
+        profile static_eth0
+        static ip_address=10.10.0.23/24
+        
+        interface eth0
+        fallback static_eth0
+
+### First Boot
+
+- Hook up pi to configuration system via ethernet, screen is optional. Insert SD-card, plug in OnOff SHIM
+
+- Connect via ssh:
+
+        ssh pi@10.10.0.23
+
+- Use raspi-config tool to
+
+  * *(optional)* set up WiFi and connect (for updates, ...)
+
+  * enable camera
+  
+  * enable serial
+
+  * change password to `pizzabox`
+  
+  Apply changes and reboot.
+  
+### Install Software
+
+- Update system
+
+        sudo apt update
+        sudo apt full-upgrade
+
+- Install python libraries:
+
+        sudo apt install git python3-picamera python3-gpiozero python3-pip python3-setuptools python3-serial
+        
+- Update NumPy:
+
+        pip3 install numpy --upgrade
+        
+  To fix bug with NumPy dependencies on Raspberry Pi install libatlas [source](https://numpy.org/devdocs/user/troubleshooting-importerror.html):
+  
+        sudo apt-get install libatlas-base-dev
+        
+- Install dependencies for python `sounddevice` library:
+
+        sudo apt install libportaudio2
+        
+- Install `gpac` for the video convertion tool *MP4Box*:
+
+        sudo apt install gpac
+        
+- Install `pydub` python library for mp3 support:
+
+        pip3 install pydub
+        
+### Install Soundcard and Make Default
+
+- Set external soundcard as default [how-to](https://www.raspberrypi-spy.co.uk/2019/06/using-a-usb-audio-device-with-the-raspberry-pi/)
+
+- When hotplugged, the sound card may not be activated. If true, reboot.
+
+- To see if the sound card was registered, run
+
+        aplay -l
+        
+  Produces output similar to
+  
+        **** List of PLAYBACK Hardware Devices ****
+        card 0: b1 [bcm2835 HDMI 1], device 0: bcm2835 HDMI 1 [bcm2835 HDMI 1]
+          Subdevices: 4/4
+          Subdevice #0: subdevice #0
+          Subdevice #1: subdevice #1
+          Subdevice #2: subdevice #2
+          Subdevice #3: subdevice #3
+        card 1: Headphones [bcm2835 Headphones], device 0: bcm2835 Headphones [bcm2835 Headphones]
+          Subdevices: 4/4
+          Subdevice #0: subdevice #0
+          Subdevice #1: subdevice #1
+          Subdevice #2: subdevice #2
+          Subdevice #3: subdevice #3
+        card 2: Device [USB PnP Sound Device], device 0: USB Audio [USB Audio]
+          Subdevices: 1/1
+          Subdevice #0: subdevice #0
+          
+  `card 2` is the usb sound card.
+
+- Edit the file `/usr/share/alsa/alsa.conf`:
+
+  Change the following lines (change the `0` to `2`)
+  
+        defaults.ctl.card 2
+        defaults.pcm.card 2
+        
+- Test the speakers:
+
+        speaker-test -c2
+        
+  Should play white noise on the left and right channel.
+  
+- Test the mic:
+
+        arecord -d 10 -f cd -t wav test.wav
+        aplay test.wav
+
+- To set gain levels etc. run:
+
+        alsamixer
+        
+## Set Up Camera
+
+- Plug in camera with ribbon cable (requires reboot)
+
+- Test camera (with screen plugged in):
+  
+        raspistill -t 1 -o test.jpg
+        
+  Download test.jpg using sftp.
+  
+## Set Up OnOff Shim:
+
+- Use the one-line installer:
+
+        curl https://get.pimoroni.com/onoffshim | bash
+        
+## Python Development on Raspi (pizzabox-main)
+
+- clone github repository `https://git.theater.digital/johannes.payr/pizzabox-main.git`
+
+- *(For now)* Use Pycharm. Set up remote python interpreter on raspberry pi:
+
+        SSH Server: 10.10.0.23
+        User Name:  pi
+        Path:       /usr/bin/python3
+        
+- install missing packages: `'click', 'sounddevice', 'soundfile', 'scipy'`
+        
+
+