Skip to content
Want to play around with all these MODEP plugins?
Get the best experience with Pisound - our low-latency stereo sound card and MIDI interface for Raspberry Pi.
Grab one here!

Guides & FAQs

Connecting to Raspberry Pi via SSH

  • Connect your Raspberry Pi via the "Patchbox" Wi-Fi SSID using your computer or smartphone/tablet (default password = blokaslabs) or connect your Raspberry Pi to your local network using an Ethernet cable.
  • If connected via "Patchbox" WiFi, the Raspberry Pi IP address is 172.24.1.1, otherwise find out the IP address of your Pi by following this guide.
  • Choose one of the following options based on the device you want to control your Pi with.

Note: the default username is patch and the default password is blokaslabs.

Option 01: Using Linux or macOS computer

  1. Connect your computer to the same network as Raspberry Pi
  2. Open a terminal window and type ssh patch@IP_ADDRESS (for the IP_ADDRESS use the IP address from the previous step)
  3. (optional) Edit your /etc/hosts file and add 172.24.1.1 patchbox.local if you want to use ssh patch@patchbox.local. The IP address may change if you are using ethernet, see above steps for that IP.

Option 02: Using Windows computer

  1. Download and install PuTTY software from https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
  2. Connect your computer to the same Network as Raspberry Pi
  3. Launch PuTTY client
  4. Enter the IP address from the previous step and click Open

Option 03: Using Android or iOS device

  1. Download Termius App from http://www.termius.com/
  2. Connect your device to the same Network as Raspberry Pi
  3. Open the Termius App
  4. Enter an alias of your choosing
  5. Enter the IP address from the previous step under hostname
  6. Complete the username and password fields and hit Save in the top right corner

Determining the IP Address of your Pi

Step 00: Patchbox Hotspot

If you are connected to the Raspberry Pi via "Patchbox" Wi-Fi hotspot, the Raspberry Pi’s IP is 172.24.1.1. If that’s the case, you can skip the following steps. 😉

Step 01: Connect your Raspberry Pi to your local Network

Connect your Raspberry Pi to your local network using an Ethernet cable or Wi-Fi.

Step 02: Find out the IP address

Option 01: Using monitor and keyboard

  1. Connect monitor and keyboard to your Raspberry Pi
  2. Make sure your Raspberry Pi is powered on and wait for it to boot
  3. Open a terminal window and type ifconfig -a
  4. In the output you will see the inet addr line displaying the IP, e.g. 192.168.1.10

Option 02: Using your tablet/smartphone & Fing App

  1. Download the Fing app for Android or iOS
  2. Connect your tablet/smartphone to the same Network as Raspberry Pi
  3. Open the Fing app and touch the refresh button in the upper right-hand corner of the screen
  4. Scroll down to the entry with the manufacturer "Raspberry Pi""
  5. You will see the IP address in the bottom left-hand corner

Option 03: Using your computer & Ping command

  1. Connect your computer to the same Network as Raspberry Pi
  2. Open a terminal window (Command Prompt on Windows)
  3. Run the following command ping patchbox.local
  4. On Windows PC, mDNS driver is required for .local addresses to work, you may install this service: Bonjour Print Services for Windows
  5. If the Raspberry Pi is reachable, ping will show its IP address, e.g: PING patchbox.local (192.168.1.33): 56 data bytes 64 bytes from 192.168.1.33: icmp_seq=0 ttl=255 time=2.618 ms

Option 04: Using your computer & Angry IP Scanner software

  1. Download and install Angry IP Scanner software via https://angryip.org/
  2. Connect your computer to the same Network as Raspberry Pi
  3. Launch Angry IP Scanner and press Start button
  4. Scroll down to the entry with your Raspberry Pi’s hostname
  5. You will see the IP address in the column on the left

Option 05: Router Web GUI

  1. Login into your local router via its webgui (usually something like http://192.168.1.254)
  2. Go to network map or network overview.
  3. Look up a device called raspberrypi or patchbox.
  4. The IP should be listed somewhere there.

Note: Your Raspberry Pi may have a different IP address depending on whether it’s connected to WiFi or Ethernet, and that address might even change from time to time. If you ever find yourself unable to connect, you can always double-check!

Test Connectivity Between Pi and PC/Laptop

  1. In a terminal window (cmd on Windows), run ping <IP-Address>
  2. If connectivity is good, you should see response times getting logged.
  3. On Windows, by default 4 ping requests are made and the utility exits.
  4. On other OSes, by default you have to manually quit by hitting Ctrl+C.

Editing Configuration Files

If you ever find a need to edit something, like Jack configuration, then here's a quick guide on how to modify system configuration files. Once connected via ssh, use a text editor to edit the file, the most popular ones are covered here:

nano: A simple text editor with familiar user interface to GUI based notepads.

  1. sudo nano /etc/jackdrc
  2. Make your changes using cursor keys to navigate.
  3. Hit 'Ctrl+X' to close, press 'Y' to confirm saving your changes.

vi: A modal commands based text editor with rich features.

  1. sudo vi /etc/jackdrc
  2. Navigate to the place you want to change using h, j, k, l keys.
  3. Enter 'insert mode' by pressing 'i' key.
  4. Make your changes.
  5. Hit 'Esc' key to go back to command mode.
  6. Type :wq to write the changes and quit the editor.

Comments & Questions

For more tips & tricks join our community forums! 👋
If you have any questions about the information on this page let us know below! 👇