Set up a Raspberry Pi for Fractal Remote
Fractal Remote · last updated 14 October 2026
A Raspberry Pi is a small, inexpensive computer, about the size of a deck of cards. Set up once, it sits by your Fractal unit, on your pedalboard or in your rack, with the unit plugged into it, and runs the Fractal Remote app all by itself. Your phone controls the unit through it, so there is no laptop at the gig. After the setup it needs no screen, keyboard or mouse: switch it on, and your phone finds your unit.
The Fractal Remote app is new on the Raspberry Pi. Every new version is started with no window, the way a pedalboard Pi starts it, on a computer with the same kind of processor as a Pi, but it is still being tried on real ones. If it works on yours, or something here doesn’t match what you see, please say so: in the app, Settings → Troubleshooting → Feedback, or by email from the support page.
On this page: which Pi · what to buy · setting it up · if something goes wrong · for gigs
Which Raspberry Pi
It needs a Pi that can run the 64-bit Raspberry Pi OS with its desktop, and enough memory for that desktop and the app together.
Good: pick one of these
- Raspberry Pi 5 with 2 GB or more. The best pick, and the 4 GB is plenty. Give it a case with a fan.
- Raspberry Pi 4 with 2 GB or more. A little slower than a Pi 5, and still plenty for this.
- Raspberry Pi 400, 500 or 500+. A Pi built into a keyboard, so it suits a desk or a rack better than a pedalboard.
Works, but slower
- Raspberry Pi 3 Model B or B+. 1 GB of memory: a slow first start, and memory is tight. The Model B’s wifi only sees 2.4 GHz networks.
- A Pi 4 or Pi 5 with 1 GB. Tight on memory. Raspberry Pi itself doesn’t recommend 1 GB for the desktop.
Not recommended
- Raspberry Pi Zero 2 W and Pi 3 Model A+. Only 512 MB of memory. The system goes on, but that is very likely too little for the desktop and the app together, and each has only one USB port.
Won’t work
- Raspberry Pi 2, every Raspberry Pi 1, and the first Zero, Zero W and Zero WH. They can only run the 32-bit Raspberry Pi OS, and the Fractal Remote app needs the 64-bit one.
Compute Modules are a Pi on a small card, made to be built into other things, with nothing to plug into until they have a board of their own. They aren’t covered here.
Already have a Pi 3?
It should work, but expect it to be slower, and its memory to be tight with the desktop and the app together: the first start after switching on can take several minutes. Once it starts by itself at power-on, if it runs out of memory, the part of the app that talks to your unit starts again by itself. These help:
- Use the official Raspberry Pi 12.5W micro USB power supply. A phone charger may not give it enough power.
- Switch off Active Desktop: Raspberry Pi menu → Preferences → Control Centre → Desktop, and turn off Active Desktop. Raspberry Pi recommends that on any Pi with less than 2 GB, and a Pi 3 may suggest it by itself when it starts. It only takes the icons off the desktop.
- Close the web browser on the Pi once the app is downloaded. It is the heaviest thing a Pi 3 runs.
- Switch on Start when this computer turns on (the steps below do), so the app runs with no window, and close screen sharing when you are done with it.
- A Pi 3 Model B only sees 2.4 GHz wifi. At home, choose your router’s 2.4 GHz network. With an iPhone’s hotspot, switch on Maximize Compatibility in Settings → Personal Hotspot (iPhone 12 or later; older iPhones already use 2.4 GHz).
- Give it a few minutes after switching on before you expect the phone to find it.
If it still struggles, slow to answer or dropping out, a Pi 4 or Pi 5 with 2 GB or more is the fix, and every step on this page is the same on those.
What to buy
For the recommended Raspberry Pi 5 with 4 GB:
- A Raspberry Pi 5, 4 GB.
- The official Raspberry Pi 27W USB-C Power Supply. A Pi 5 needs 5 volts at 5 amps, and on a lesser supply it holds back the power it gives its USB ports.
- A case with a fan, such as the official Raspberry Pi 5 case, which has one built in. A Pi 5 runs best kept cool.
- A microSD card of 32 GB or more. It gets wiped, so a blank one is fine.
-
The USB cable for your unit:
- FM3, FM9 or Axe-Fx III: USB-A to USB-B, the squarer plug at the unit’s end, often called a printer cable.
- AM4: USB-A to USB-C.
- Any other unit: USB-A at the Pi’s end, and at the other end the plug your unit takes.
You also need Fractal Remote on your phone with the phone remote unlocked (the one-time purchase inside the phone app), and the account you use on the phone: the app on the Pi signs in with the same one. And an internet connection for the Pi: your wifi, or a network cable to your router.
And for the way you set it up
- From a Mac, a Windows PC or a Linux computer: a USB microSD card reader that fits that computer, a USB-C one if it only has USB-C ports. A computer with an SD card slot can use the full-size adapter that often comes with the card instead. No keyboard, mouse or screen for the Pi. On a Pi 3, have a TV or monitor, an ordinary HDMI cable, a USB keyboard and a USB mouse you could borrow, in case screen sharing doesn’t start.
- With a keyboard, mouse and screen on the Pi: a USB keyboard and a USB mouse (a wireless pair with its own small USB plug works too), a TV or monitor with an HDMI input, and a micro-HDMI to HDMI cable. To put the system on the card you also need one of these: a card reader and any computer, a card bought already loaded with Raspberry Pi OS, or, on a Pi 4, 400, 5, 500 or 500+, a network cable to your router.
On a Pi 4 or Pi 3 instead
- Pi 4 (and Pi 400): the official Raspberry Pi 15W USB-C Power Supply. Its screen plugs in with a micro-HDMI to HDMI cable, as on a Pi 5. A fan is optional; it stops the Pi slowing itself down when it gets hot.
- Pi 3: the official Raspberry Pi 12.5W micro USB Power Supply. Its screen plugs in with an ordinary HDMI cable. It needs no fan.
No prices or shop links here, because they change. Raspberry Pi’s own website lists the official parts and who sells them.
Setting it up
You do this once. Set aside an hour or so, much of it waiting. Afterwards the Pi needs no screen.
How are you setting it up?
Pick one to see its steps.
There are four ways, one after another below. Jump to yours: From a Mac · From a Windows PC · From a Linux computer · With a keyboard, mouse and screen on the Pi
From a Mac
You put the system on the memory card with your Mac, then see and use the Pi’s desktop in a web browser on your Mac. Nothing plugs into the Pi but its power, and later your unit. Have the card reader and your wifi’s name and password ready.
Your Mac needs macOS 13 Ventura or newer: the Apple menu, then About This Mac, shows which it has. On an older Mac, Raspberry Pi Imager won’t open, so take With a keyboard, mouse and screen on the Pi instead, with a card bought already loaded with Raspberry Pi OS, or, on a Pi 4 or Pi 5, with no other computer at all.
1. Put Raspberry Pi OS on the memory card
- On your Mac, go to raspberrypi.com/software and click Download for macOS.
- Open the file you downloaded (its name starts with imager and ends in .dmg), and drag Raspberry Pi Imager into the Applications folder.
- Open Raspberry Pi Imager from Applications. If your Mac asks whether you are sure you want to open it, click Open.
- Put the memory card in the card reader, and plug the reader into your Mac.
- On the Device screen, choose your Pi: Raspberry Pi 5 (also the one for a Pi 500 or 500+), Raspberry Pi 4 (also the one for a Pi 400) or Raspberry Pi 3. Click Next.
- On the OS screen, choose Raspberry Pi OS (64-bit), the first one, marked Recommended. Not Raspberry Pi OS (32-bit) just under it, and nothing under Raspberry Pi OS (other): the Lite system there has no desktop, and the app needs one. Click Next.
- On the Storage screen, choose your memory card (check its size, so you know it is the card), leave Exclude system drives ticked, and click Next.
- Hostname: type a name for the Pi, using only letters, numbers and hyphens, such as
pedalboard. Click Next. - Localisation: choose your capital city. That sets the time zone, the keyboard and the wifi country. Click Next.
- User: choose a username (small letters and numbers only) and a password, and write both down. Click Next.
- Wi-Fi: Imager may fill in the network your Mac is on. If it asks whether to fill in the wifi password from your Mac’s keychain, say yes and type your Mac’s password. Fill in whatever it left empty: leave Secure network chosen, type your wifi’s name in the SSID box exactly as it appears (capitals and spaces count), and type the wifi password in both password boxes. Leave Hidden SSID unticked. The Pi has to join this network by itself the first time it starts, so check every letter. Click Next. On a Pi 3: choose a 2.4 GHz network. A Pi 3 Model B can’t see 5 GHz ones, and if your router shows two names, the 5 GHz one often ends in 5G.
- Remote access: leave Enable SSH off, and click Next.
- Raspberry Pi Connect: switch on Enable Raspberry Pi Connect, then click Open Raspberry Pi Connect. Your web browser opens.
- In the browser, sign in with your Raspberry Pi ID, or sign up for one. It’s free, and it is an account with Raspberry Pi, not your Fractal Remote one.
- On the New auth key page, click Create auth key and launch Raspberry Pi Imager. If the browser asks whether to open Raspberry Pi Imager, say yes.
- Back in Imager, the Authentication token box has filled itself in with a long code, and the Open Raspberry Pi Connect button has gone. Click Next. (If the box is still empty after half a minute, open Having trouble? on that web page, copy the key, and paste it into the box.)
- If Imager shows any other screen, leave it as it is and click Next.
- Click Write, then I understand, erase and write. Type your Mac’s password if it asks.
- Wait while it writes the card and then checks it. That takes several minutes. When Imager says Write complete!, wait until it says the storage device (the card) was ejected (if it shows an Eject button instead, click Eject), then click Finish. If your Mac says the disk isn’t readable, now or while it writes, click Ignore. Never Initialize: that wipes what was just written.
- Take the card out. Start the Pi with it within six hours: the Connect key Imager put on the card stops working after that. If you miss it, write the card again.
2. Start the Pi, and see its desktop on your Mac
- Put the Pi in its case, following the leaflet that comes with the case (a Pi 400, 500 or 500+ is its own case, so skip this). In the official Raspberry Pi 5 case, plug the fan’s small cable into the little socket marked FAN on the Pi before you put the lid on.
- Push the memory card into the Pi’s card slot, printed side facing away from the board. On a Pi 5, 4 or 3 the slot is underneath, at the end away from the USB ports.
- Plug the power supply into the Pi and into the wall. The Pi starts by itself. The first start takes several minutes while it sets itself up and joins your wifi, and longer on a Pi 3.
- On your Mac, go to connect.raspberrypi.com in the web browser and sign in with your Raspberry Pi ID. If the browser asks to find devices on your local network, allow it.
- Open the Devices tab. Your Pi is listed there, with a Screen sharing badge under its name. If it isn’t there after ten minutes, see If something goes wrong.
- Click Connect via, then Screen sharing. The Pi’s desktop opens in your browser, and your Mac’s mouse and keyboard work it. On a Pi 3: screen sharing should work on today’s Raspberry Pi OS, but nobody has tried it with this app on a Pi 3 yet. If your Pi still shows no Screen sharing badge after you unplug its power and plug it back in, plug a TV or monitor (with an ordinary HDMI cable), a USB keyboard and a USB mouse into the Pi. Unplug the Pi’s power and plug it back in, then do parts 3 and 4 below on the TV instead of in your browser. In part 4, unplug the keyboard, mouse and TV before you plug the power back in.
3. Put the Fractal Remote app on the Pi
- On the Pi’s own desktop (in the screen sharing window, or on the TV if part 2 sent a Pi 3 there), open the web browser: click the Raspberry Pi menu at the top left, then Internet, then Chromium (or Firefox).
- In the Pi’s web browser, click its address bar. On screen sharing, that is the one inside the picture of the Pi’s desktop, not your own browser’s at the very top. Type
fractal.newbold.cloud/downloadsthere and press Enter. Type it on the Pi: clicking it on this page would open it on whatever you are reading this on. - Click Raspberry Pi and other ARM — AppImage (it may start with “Download for”). Not the Linux PC one, and not the .deb. If the browser asks whether to keep the file, choose Keep.
- If the download page asks you to check the Pi’s system first, you can skip that: you chose Raspberry Pi OS (64-bit) in Imager.
- When it has downloaded, close the Pi’s web browser with the × at its top right. On screen sharing, close only that one, inside the picture, and leave your own browser open. The Pi’s browser is the heaviest thing a Pi runs, most of all a Pi 3.
- Open the file manager: Raspberry Pi menu, then Accessories, then File Manager. Open the Downloads folder.
- Right-click the file whose name ends in arm64.AppImage (with a Mac trackpad, click with two fingers), choose Properties, and on the Permissions tab set Execute to Anyone. Click OK.
- Double-click the file. If it asks whether to execute it, choose Execute. The Fractal Remote app opens. Leave the file where it is from now on: it is the app itself. On a Pi 3: the app can take a minute or more to open the first time.
- The app opens on its welcome screen. (If it doesn’t, open Settings with the gear ⚙ at the top right and choose Show the walkthrough.) Choose I already have an account, type the email and password of your Fractal Remote account, the same one as on your phone, and click Turn on. No account yet? Choose Create account there instead.
- Open Settings (the gear ⚙ at the top right), choose About, and tick Start when this computer turns on.
- Plug your unit into one of the Pi’s USB ports with its USB cable, and switch the unit on.
- On your phone, open Fractal Remote, signed in to that same account. It finds the Pi and shows your unit. If it says there is no computer, tap Look for the computer again.
4. Test it the way it will be used
- On the Pi’s desktop, click the Raspberry Pi menu, then Shutdown, then Shutdown. The screen sharing ends.
- Wait half a minute, unplug the Pi’s power, and plug it back in.
- Give it a few minutes, longer on a Pi 3. With nobody there, the Pi starts, the app starts by itself with no window, and your phone finds your unit again.
- That’s it. From now on, switch the Pi on and your phone finds your unit. Whenever you want the Pi’s desktop again, connect.raspberrypi.com shows it while the Pi is online, from any web browser, your phone’s included.
Setting it up another way? Back to the four choices
From a Windows PC
You put the system on the memory card with your PC, then see and use the Pi’s desktop in a web browser on your PC. Nothing plugs into the Pi but its power, and later your unit. Have the card reader and your wifi’s name and password ready.
1. Put Raspberry Pi OS on the memory card
- On your PC, go to raspberrypi.com/software and click Download for Windows.
- Open the file you downloaded (its name starts with imager and ends in .exe). If Windows asks Do you want to allow this app to make changes to your device?, click Yes. If a blue box says Windows protected your PC, click More info, then Run anyway. Follow the installer to the end.
- Open Raspberry Pi Imager from the Start menu. If Windows asks again whether to allow it to make changes, click Yes.
- Put the memory card in the card reader, and plug the reader into your PC.
- On the Device screen, choose your Pi: Raspberry Pi 5 (also the one for a Pi 500 or 500+), Raspberry Pi 4 (also the one for a Pi 400) or Raspberry Pi 3. Click Next.
- On the OS screen, choose Raspberry Pi OS (64-bit), the first one, marked Recommended. Not Raspberry Pi OS (32-bit) just under it, and nothing under Raspberry Pi OS (other): the Lite system there has no desktop, and the app needs one. Click Next.
- On the Storage screen, choose your memory card (check its size, so you know it is the card), leave Exclude system drives ticked, and click Next.
- Hostname: type a name for the Pi, using only letters, numbers and hyphens, such as
pedalboard. Click Next. - Localisation: choose your capital city. That sets the time zone, the keyboard and the wifi country. Click Next.
- User: choose a username (small letters and numbers only) and a password, and write both down. Click Next.
- Wi-Fi: Imager may fill in the network your PC is on. Fill in whatever it left empty: leave Secure network chosen, type your wifi’s name in the SSID box exactly as it appears (capitals and spaces count), and type the wifi password in both password boxes. Leave Hidden SSID unticked. The Pi has to join this network by itself the first time it starts, so check every letter. Click Next. On a Pi 3: choose a 2.4 GHz network. A Pi 3 Model B can’t see 5 GHz ones, and if your router shows two names, the 5 GHz one often ends in 5G.
- Remote access: leave Enable SSH off, and click Next.
- Raspberry Pi Connect: switch on Enable Raspberry Pi Connect, then click Open Raspberry Pi Connect. Your web browser opens.
- In the browser, sign in with your Raspberry Pi ID, or sign up for one. It’s free, and it is an account with Raspberry Pi, not your Fractal Remote one.
- On the New auth key page, click Create auth key and launch Raspberry Pi Imager. If the browser asks whether to open Raspberry Pi Imager, say yes.
- Back in Imager, the Authentication token box has filled itself in with a long code, and the Open Raspberry Pi Connect button has gone. Click Next. (If the box is still empty after half a minute, open Having trouble? on that web page, copy the key, and paste it into the box.)
- If Imager shows any other screen, leave it as it is and click Next.
- Click Write, then I understand, erase and write. If Windows asks whether to allow it, click Yes.
- Wait while it writes the card and then checks it. That takes several minutes. When Imager says Write complete!, wait until it says the storage device (the card) was ejected (if it shows an Eject button instead, click Eject), then click Finish. If Windows says you need to format the disk, now or while it writes, click Cancel. Never Format: that wipes what was just written. Leave the small drive called bootfs alone too.
- Take the card out. Start the Pi with it within six hours: the Connect key Imager put on the card stops working after that. If you miss it, write the card again.
2. Start the Pi, and see its desktop on your PC
- Put the Pi in its case, following the leaflet that comes with the case (a Pi 400, 500 or 500+ is its own case, so skip this). In the official Raspberry Pi 5 case, plug the fan’s small cable into the little socket marked FAN on the Pi before you put the lid on.
- Push the memory card into the Pi’s card slot, printed side facing away from the board. On a Pi 5, 4 or 3 the slot is underneath, at the end away from the USB ports.
- Plug the power supply into the Pi and into the wall. The Pi starts by itself. The first start takes several minutes while it sets itself up and joins your wifi, and longer on a Pi 3.
- On your PC, go to connect.raspberrypi.com in the web browser and sign in with your Raspberry Pi ID. If the browser asks to find devices on your local network, allow it.
- Open the Devices tab. Your Pi is listed there, with a Screen sharing badge under its name. If it isn’t there after ten minutes, see If something goes wrong.
- Click Connect via, then Screen sharing. The Pi’s desktop opens in your browser, and your PC’s mouse and keyboard work it. On a Pi 3: screen sharing should work on today’s Raspberry Pi OS, but nobody has tried it with this app on a Pi 3 yet. If your Pi still shows no Screen sharing badge after you unplug its power and plug it back in, plug a TV or monitor (with an ordinary HDMI cable), a USB keyboard and a USB mouse into the Pi. Unplug the Pi’s power and plug it back in, then do parts 3 and 4 below on the TV instead of in your browser. In part 4, unplug the keyboard, mouse and TV before you plug the power back in.
3. Put the Fractal Remote app on the Pi
- On the Pi’s own desktop (in the screen sharing window, or on the TV if part 2 sent a Pi 3 there), open the web browser: click the Raspberry Pi menu at the top left, then Internet, then Chromium (or Firefox).
- In the Pi’s web browser, click its address bar. On screen sharing, that is the one inside the picture of the Pi’s desktop, not your own browser’s at the very top. Type
fractal.newbold.cloud/downloadsthere and press Enter. Type it on the Pi: clicking it on this page would open it on whatever you are reading this on. - Click Raspberry Pi and other ARM — AppImage (it may start with “Download for”). Not the Linux PC one, and not the .deb. If the browser asks whether to keep the file, choose Keep.
- If the download page asks you to check the Pi’s system first, you can skip that: you chose Raspberry Pi OS (64-bit) in Imager.
- When it has downloaded, close the Pi’s web browser with the × at its top right. On screen sharing, close only that one, inside the picture, and leave your own browser open. The Pi’s browser is the heaviest thing a Pi runs, most of all a Pi 3.
- Open the file manager: Raspberry Pi menu, then Accessories, then File Manager. Open the Downloads folder.
- Right-click the file whose name ends in arm64.AppImage (on a laptop touchpad, tap with two fingers), choose Properties, and on the Permissions tab set Execute to Anyone. Click OK.
- Double-click the file. If it asks whether to execute it, choose Execute. The Fractal Remote app opens. Leave the file where it is from now on: it is the app itself. On a Pi 3: the app can take a minute or more to open the first time.
- The app opens on its welcome screen. (If it doesn’t, open Settings with the gear ⚙ at the top right and choose Show the walkthrough.) Choose I already have an account, type the email and password of your Fractal Remote account, the same one as on your phone, and click Turn on. No account yet? Choose Create account there instead.
- Open Settings (the gear ⚙ at the top right), choose About, and tick Start when this computer turns on.
- Plug your unit into one of the Pi’s USB ports with its USB cable, and switch the unit on.
- On your phone, open Fractal Remote, signed in to that same account. It finds the Pi and shows your unit. If it says there is no computer, tap Look for the computer again.
4. Test it the way it will be used
- On the Pi’s desktop, click the Raspberry Pi menu, then Shutdown, then Shutdown. The screen sharing ends.
- Wait half a minute, unplug the Pi’s power, and plug it back in.
- Give it a few minutes, longer on a Pi 3. With nobody there, the Pi starts, the app starts by itself with no window, and your phone finds your unit again.
- That’s it. From now on, switch the Pi on and your phone finds your unit. Whenever you want the Pi’s desktop again, connect.raspberrypi.com shows it while the Pi is online, from any web browser, your phone’s included.
Setting it up another way? Back to the four choices
From a Linux computer
You put the system on the memory card with your Linux computer, then see and use the Pi’s desktop in a web browser on that computer. Nothing plugs into the Pi but its power, and later your unit. Have the card reader and your wifi’s name and password ready.
1. Put Raspberry Pi OS on the memory card
Is your Linux computer itself a Raspberry Pi? Then, instead of the first four steps, open Terminal, type sudo apt install rpi-imager and press Enter (it may say it is already installed), then open Imager from the Raspberry Pi menu → Accessories → Imager. Use a USB card reader for the new card, because the Pi’s own card slot holds its system.
- On your computer, go to raspberrypi.com/software and click Download for Linux (x86_64). That one is for an ordinary Intel or AMD computer. Take it from there rather than from your computer’s software store, which can have an older Imager without the Raspberry Pi Connect step.
- Let the file run as a program: right-click it, choose Properties, and on the Permissions tab tick the box (or switch) that lets it run as a program. Each computer words it a little differently. Or, in Terminal, type
cd Downloadsand press Enter, then typechmod +xfollowed by a space and the file’s name (it starts with imager_ and ends in .AppImage), and press Enter. - Double-click the file to open Raspberry Pi Imager. It may ask for your computer’s password, so that it can write to the card.
- If Imager can’t see or write the card, close it, open Terminal, type
cd Downloadsand press Enter, then typesudo ./followed by the file’s name, and press Enter. Type your computer’s password when it asks. - Put the memory card in the card reader, and plug the reader into your computer.
- On the Device screen, choose your Pi: Raspberry Pi 5 (also the one for a Pi 500 or 500+), Raspberry Pi 4 (also the one for a Pi 400) or Raspberry Pi 3. Click Next.
- On the OS screen, choose Raspberry Pi OS (64-bit), the first one, marked Recommended. Not Raspberry Pi OS (32-bit) just under it, and nothing under Raspberry Pi OS (other): the Lite system there has no desktop, and the app needs one. Click Next.
- On the Storage screen, choose your memory card (check its size, so you know it is the card), leave Exclude system drives ticked, and click Next.
- Hostname: type a name for the Pi, using only letters, numbers and hyphens, such as
pedalboard. Click Next. - Localisation: choose your capital city. That sets the time zone, the keyboard and the wifi country. Click Next.
- User: choose a username (small letters and numbers only) and a password, and write both down. Click Next.
- Wi-Fi: Imager may fill in the network your computer is on. Fill in whatever it left empty: leave Secure network chosen, type your wifi’s name in the SSID box exactly as it appears (capitals and spaces count), and type the wifi password in both password boxes. Leave Hidden SSID unticked. The Pi has to join this network by itself the first time it starts, so check every letter. Click Next. On a Pi 3: choose a 2.4 GHz network. A Pi 3 Model B can’t see 5 GHz ones, and if your router shows two names, the 5 GHz one often ends in 5G.
- Remote access: leave Enable SSH off, and click Next.
- Raspberry Pi Connect: switch on Enable Raspberry Pi Connect, then click Open Raspberry Pi Connect. Your web browser opens.
- In the browser, sign in with your Raspberry Pi ID, or sign up for one. It’s free, and it is an account with Raspberry Pi, not your Fractal Remote one.
- On the New auth key page, click Create auth key and launch Raspberry Pi Imager. If the browser asks whether to open Raspberry Pi Imager, say yes.
- Back in Imager, the Authentication token box has filled itself in with a long code, and the Open Raspberry Pi Connect button has gone. Click Next. (If the box is still empty after half a minute, open Having trouble? on that web page, copy the key, and paste it into the box.)
- If Imager shows any other screen, leave it as it is and click Next.
- Click Write, then I understand, erase and write. Type your computer’s password if it asks.
- Wait while it writes the card and then checks it. That takes several minutes. When Imager says Write complete!, wait until it says the storage device (the card) was ejected (if it shows an Eject button instead, click Eject), then click Finish.
- Take the card out. Start the Pi with it within six hours: the Connect key Imager put on the card stops working after that. If you miss it, write the card again.
2. Start the Pi, and see its desktop on your computer
- Put the Pi in its case, following the leaflet that comes with the case (a Pi 400, 500 or 500+ is its own case, so skip this). In the official Raspberry Pi 5 case, plug the fan’s small cable into the little socket marked FAN on the Pi before you put the lid on.
- Push the memory card into the Pi’s card slot, printed side facing away from the board. On a Pi 5, 4 or 3 the slot is underneath, at the end away from the USB ports.
- Plug the power supply into the Pi and into the wall. The Pi starts by itself. The first start takes several minutes while it sets itself up and joins your wifi, and longer on a Pi 3.
- On your computer, go to connect.raspberrypi.com in the web browser and sign in with your Raspberry Pi ID. If the browser asks to find devices on your local network, allow it.
- Open the Devices tab. Your Pi is listed there, with a Screen sharing badge under its name. If it isn’t there after ten minutes, see If something goes wrong.
- Click Connect via, then Screen sharing. The Pi’s desktop opens in your browser, and your computer’s mouse and keyboard work it. On a Pi 3: screen sharing should work on today’s Raspberry Pi OS, but nobody has tried it with this app on a Pi 3 yet. If your Pi still shows no Screen sharing badge after you unplug its power and plug it back in, plug a TV or monitor (with an ordinary HDMI cable), a USB keyboard and a USB mouse into the Pi. Unplug the Pi’s power and plug it back in, then do parts 3 and 4 below on the TV instead of in your browser. In part 4, unplug the keyboard, mouse and TV before you plug the power back in.
3. Put the Fractal Remote app on the Pi
- On the Pi’s own desktop (in the screen sharing window, or on the TV if part 2 sent a Pi 3 there), open the web browser: click the Raspberry Pi menu at the top left, then Internet, then Chromium (or Firefox).
- In the Pi’s web browser, click its address bar. On screen sharing, that is the one inside the picture of the Pi’s desktop, not your own browser’s at the very top. Type
fractal.newbold.cloud/downloadsthere and press Enter. Type it on the Pi: clicking it on this page would open it on whatever you are reading this on. - Click Raspberry Pi and other ARM — AppImage (it may start with “Download for”). Not the Linux PC one, and not the .deb. If the browser asks whether to keep the file, choose Keep.
- If the download page asks you to check the Pi’s system first, you can skip that: you chose Raspberry Pi OS (64-bit) in Imager.
- When it has downloaded, close the Pi’s web browser with the × at its top right. On screen sharing, close only that one, inside the picture, and leave your own browser open. The Pi’s browser is the heaviest thing a Pi runs, most of all a Pi 3.
- Open the file manager: Raspberry Pi menu, then Accessories, then File Manager. Open the Downloads folder.
- Right-click the file whose name ends in arm64.AppImage (on a touchpad, tap or click with two fingers), choose Properties, and on the Permissions tab set Execute to Anyone. Click OK.
- Double-click the file. If it asks whether to execute it, choose Execute. The Fractal Remote app opens. Leave the file where it is from now on: it is the app itself. On a Pi 3: the app can take a minute or more to open the first time.
- The app opens on its welcome screen. (If it doesn’t, open Settings with the gear ⚙ at the top right and choose Show the walkthrough.) Choose I already have an account, type the email and password of your Fractal Remote account, the same one as on your phone, and click Turn on. No account yet? Choose Create account there instead.
- Open Settings (the gear ⚙ at the top right), choose About, and tick Start when this computer turns on.
- Plug your unit into one of the Pi’s USB ports with its USB cable, and switch the unit on.
- On your phone, open Fractal Remote, signed in to that same account. It finds the Pi and shows your unit. If it says there is no computer, tap Look for the computer again.
4. Test it the way it will be used
- On the Pi’s desktop, click the Raspberry Pi menu, then Shutdown, then Shutdown. The screen sharing ends.
- Wait half a minute, unplug the Pi’s power, and plug it back in.
- Give it a few minutes, longer on a Pi 3. With nobody there, the Pi starts, the app starts by itself with no window, and your phone finds your unit again.
- That’s it. From now on, switch the Pi on and your phone finds your unit. Whenever you want the Pi’s desktop again, connect.raspberrypi.com shows it while the Pi is online, from any web browser, your phone’s included.
Setting it up another way? Back to the four choices
With a keyboard, mouse and screen on the Pi
You plug a TV or monitor, a keyboard and a mouse into the Pi and set it up right there, like an ordinary computer. Afterwards you unplug them, and the Pi carries on without them.
1. Put the Pi in its case, and plug in the screen, the keyboard and the mouse
- Put the Pi in its case, following the leaflet that comes with the case (a Pi 400, 500 or 500+ is its own case, so skip this). In the official Raspberry Pi 5 case, plug the fan’s small cable into the little socket marked FAN on the Pi before you put the lid on.
- Plug the TV or monitor into the Pi. On a Pi 5 or Pi 4, use the micro-HDMI to HDMI cable, in the port marked HDMI0, next to the power socket. On a Pi 400, use the same kind of cable in the micro-HDMI port next to the memory card slot. On a Pi 500 or 500+, use it in the port marked HDMI0. On a Pi 3, use an ordinary HDMI cable.
- Switch the TV or monitor on, and choose that HDMI input.
- Plug the USB keyboard and the USB mouse into the Pi’s USB ports. A Pi 400, 500 or 500+ is the keyboard, so it needs only the mouse.
- Don’t plug in the Pi’s power yet.
2. Get Raspberry Pi OS onto the memory card
Three ways to do this. Take whichever fits, and skip the other two.
If the card came already loaded with Raspberry Pi OS (a kit’s card, or the one a Pi 500 comes with):
- Push the card into the Pi’s card slot, printed side facing away from the board. On a Pi 5, 4 or 3 the slot is underneath, at the end away from the USB ports. A Pi 500+ has the system on its own drive, so it needs no card.
- Then go on to 3. Start the Pi, and answer its questions. Its last step but one checks that the card holds the 64-bit system, because a loaded card doesn’t always say which it has.
If you have another computer to write the card (a Mac, a Windows PC or a Linux computer, with a card reader for it):
- On that computer, go to raspberrypi.com/software and download Raspberry Pi Imager for it. On a Mac (it needs macOS 13 Ventura or newer), open the file and drag Raspberry Pi Imager into Applications. On Windows, open the file and click Yes when it asks to make changes. On Linux, let the file run as a program (right-click it, Properties, Permissions).
- Open Raspberry Pi Imager, put the memory card in the card reader, and plug the reader in.
- On the Device screen, choose your Pi: Raspberry Pi 5 (also the one for a Pi 500 or 500+), Raspberry Pi 4 (also the one for a Pi 400) or Raspberry Pi 3. Click Next.
- On the OS screen, choose Raspberry Pi OS (64-bit), the first one, marked Recommended. Not Raspberry Pi OS (32-bit) just under it, and nothing under Raspberry Pi OS (other): the Lite system there has no desktop, and the app needs one. Click Next.
- On the Storage screen, choose your memory card (check its size), leave Exclude system drives ticked, and click Next.
- Click Skip customisation. The Pi asks the same questions on its own screen.
- Click Write, then I understand, erase and write, and allow it if the computer asks for permission or its password.
- Wait while it writes the card and then checks it, which takes several minutes. When Imager says Write complete!, wait until it says the storage device (the card) was ejected (if it shows an Eject button instead, click Eject), then click Finish. Take the card out. If the computer offers to format the card, or says it isn’t readable, say no: Cancel on Windows, Ignore on a Mac.
- Push the card into the Pi’s card slot, printed side facing away from the board. On a Pi 5, 4 or 3 the slot is underneath, at the end away from the USB ports.
With no other computer (a Pi 4, 400, 5, 500 or 500+ only, not a Pi 3):
- You need a memory card, blank or one you don’t mind wiping, and a network cable from the Pi to your router. This part doesn’t work over wifi.
- Push the card into the Pi’s card slot, printed side facing away from the board (on a Pi 5 or 4 the slot is underneath, at the end away from the USB ports), and plug in the network cable.
- Hold down Shift on the keyboard while you plug in the Pi’s power. The Pi downloads Raspberry Pi Imager and opens it on the screen, which can take a few minutes. If nothing like that appears, the Pi’s start-up software may be too old for this: take one of the other two ways instead.
- If Imager first shows Welcome and asks for a language, choose yours and click Next.
- On the Device screen, choose your Pi, and click Next.
- On the OS screen, choose Raspberry Pi OS (64-bit), the first one, marked Recommended. Not Raspberry Pi OS (32-bit) just under it, and nothing under Raspberry Pi OS (other): the Lite system there has no desktop, and the app needs one. Click Next.
- On the Storage screen, choose the memory card in the Pi (check its size, so you know it is the card), and click Next. Then click Skip customisation.
- Click Write. Here it starts writing at once, with no box asking if you are sure, so be sure you chose the card on the Storage screen. When the writing is done, it moves on to its last screen by itself. Click Reboot there. The Pi starts again from the card. If it doesn’t, unplug its power and plug it back in.
3. Start the Pi, and answer its questions
- Plug in the Pi’s power, if it isn’t on already. It starts by itself, and the first start can take a few minutes.
- Welcome to Raspberry Pi: click Next.
- Set Country: choose your country, language and time zone. Click Next.
- Create User: choose a username (small letters and numbers only) and a password, and write both down. Click Next.
- Select WiFi Network: click your network, click Next, type its password, and click Next. Do this even if a network cable is plugged in: on the pedalboard the Pi will need the wifi, or your phone’s hotspot (see For gigs). Click Skip only if the Pi will always have a network cable. On a Pi 3: choose a 2.4 GHz network. A Pi 3 Model B can’t see 5 GHz ones.
- Choose Browser: either is fine. Click Next.
- Update Software: click Next and let it update. It can take up to half an hour, and it is worth it, most of all on a card that came loaded.
- Setup Complete: click Restart or Launch, whichever it offers.
- Check it is the 64-bit system: open the Raspberry Pi menu at the top left, then Accessories, then Terminal. Type
dpkg --print-architectureand press Enter. If it says arm64, you’re set. If it says armhf, it is the 32-bit system, which the app can’t run on. If you have another computer, write the card again with it, as above, choosing Raspberry Pi OS (64-bit); that wipes the card. With no other computer, on a Pi 4, 400, 5, 500 or 500+: shut the Pi down (Raspberry Pi menu, Shutdown, Shutdown), unplug its power, and take the way With no other computer above with this same card. Holding Shift, as it says, starts it even on a card that already has a system on it. On a Pi 3 you need another computer to write the card, or a card sold loaded with Raspberry Pi OS (64-bit). - Optional, and handy later on a pedalboard: switch on Raspberry Pi Connect, so you can see the Pi’s desktop from any web browser with no screen plugged in. Click the Connect icon at the top right of the screen and choose Turn On Raspberry Pi Connect. In the browser that opens, sign in with your Raspberry Pi ID (or sign up for one; it’s free), give the Pi a name, and click Create device and sign in.
4. Put the Fractal Remote app on the Pi
- On the Pi’s desktop, on the TV, open the web browser: click the Raspberry Pi menu at the top left, then Internet, then Chromium (or Firefox).
- In the Pi’s web browser, click its address bar at the top, type
fractal.newbold.cloud/downloadsthere and press Enter. Type it on the Pi: clicking it on this page would open it on whatever you are reading this on. - Click Raspberry Pi and other ARM — AppImage (it may start with “Download for”). Not the Linux PC one, and not the .deb. If the browser asks whether to keep the file, choose Keep.
- If the download page asks you to check the Pi’s system first, you can skip that: you checked it is the 64-bit one in part 3.
- When it has downloaded, close the Pi’s web browser with the × at its top right. It is the heaviest thing a Pi runs, most of all a Pi 3.
- Open the file manager: Raspberry Pi menu, then Accessories, then File Manager. Open the Downloads folder.
- Right-click the file whose name ends in arm64.AppImage (with the right button on the mouse), choose Properties, and on the Permissions tab set Execute to Anyone. Click OK.
- Double-click the file. If it asks whether to execute it, choose Execute. The Fractal Remote app opens. Leave the file where it is from now on: it is the app itself. On a Pi 3: the app can take a minute or more to open the first time.
- The app opens on its welcome screen. (If it doesn’t, open Settings with the gear ⚙ at the top right and choose Show the walkthrough.) Choose I already have an account, type the email and password of your Fractal Remote account, the same one as on your phone, and click Turn on. No account yet? Choose Create account there instead.
- Open Settings (the gear ⚙ at the top right), choose About, and tick Start when this computer turns on.
- Plug your unit into one of the Pi’s USB ports with its USB cable, and switch the unit on.
- On your phone, open Fractal Remote, signed in to that same account. It finds the Pi and shows your unit. If it says there is no computer, tap Look for the computer again.
5. Test it the way it will be used
- Click the Raspberry Pi menu, then Shutdown, then Shutdown.
- When the screen goes dark, unplug the Pi’s power. Then unplug the keyboard, the mouse and the screen.
- Plug the power back in, with nothing else plugged into the Pi but your unit (and the network cable, if that is how this Pi always reaches the internet). Give it a few minutes, longer on a Pi 3. With nobody there, the Pi starts, the app starts by itself with no window, and your phone finds your unit again.
- That’s it. From now on, switch the Pi on and your phone finds your unit. Whenever you want the Pi’s desktop again, plug the screen, keyboard and mouse back in, or, if you switched Connect on, go to connect.raspberrypi.com from any web browser.
Setting it up another way? Back to the four choices
If something goes wrong
The TV or monitor shows nothing
- Check the cable is in the Pi’s port marked HDMI0 (on a Pi 5 or 4, the one next to the power socket; on a Pi 400, the one next to the memory card slot), and the TV is switched to that HDMI input.
- Still nothing, on a Pi with two of those small ports? Unplug the Pi’s power, move the cable to the other port, and plug the power back in.
- Switch the TV on first, then unplug the Pi’s power and plug it back in.
- Use the official power supply: on a weaker one the Pi may not start.
The Pi doesn’t show up in Connect
- Set it up with a keyboard and screen? Look at the Pi’s own screen: if the network icon at the top right shows no wifi, click it and choose your network. If it is online and still not listed, click the Connect icon there and choose Turn On Raspberry Pi Connect again.
- Give it ten minutes. The first start is slow, most of all on a Pi 3.
- Most often the wifi name or password was typed wrong in Imager, or, on a Pi 3 Model B, it is a 5 GHz network. Plug a network cable from the Pi into your router, then unplug the Pi’s power and plug it back in. If it shows up now, the wifi was the problem: on the Pi’s desktop, click the network icon at the top right and choose your wifi there.
- No network cable? Unplug the Pi’s power, take the card out, and write it again with Imager (part 1 of the Mac, Windows PC or Linux way). Imager fills in most of what you typed last time. Check the wifi name and password letter by letter, and get a new Connect key with Open Raspberry Pi Connect, as before.
- The Connect key works for six hours after Imager makes it. If the Pi first started later than that, write the card again with Imager.
- Listed, but with no Screen sharing badge? Unplug the Pi’s power and plug it back in. With no screen plugged in, screen sharing now and then doesn’t start the first time.
During setup, a box says “The device server stopped”
- The Pi ran short of memory while its window, the web browser and screen sharing were all open, most often on a Pi 3. Close the Pi’s web browser, then restart the Pi: Raspberry Pi menu → Shutdown → Reboot. Then open Fractal Remote again from Downloads.
Double-clicking the app does nothing
- Check it is the Raspberry Pi file: its name ends in arm64.AppImage. The Linux PC file can’t run on a Pi.
- Check Execute is set to Anyone: right-click the file (on a trackpad, click with two fingers), then Properties, Permissions.
- Open Terminal (Raspberry Pi menu, Accessories, Terminal), type
cd Downloadsand press Enter, then type./followed by the file’s name, and press Enter. It says what is wrong. - On a trimmed-down system, such as Raspberry Pi OS Lite with a desktop added, first type
sudo apt install libfuse2t64 zlib1g-dev(on the older Bookworm release,libfuse2in place oflibfuse2t64). The normal Raspberry Pi OS (64-bit) already has both. - A command that starts with
sudoasks for the Pi’s password, the one you chose when you set it up. Nothing shows while you type it; type it anyway and press Enter.
The phone says there is no computer
- The app on the Pi and the phone have to be signed in to the same account. On the phone, Settings → Account shows which one.
- Then, on the phone, tap Look for the computer again.
- Is the Pi on the internet? If you skipped wifi while setting it up, plug the screen, keyboard and mouse back in, click the network icon at the top right of the Pi’s desktop, and choose your wifi.
- Give it a few minutes after switching on. A Pi often starts before its wifi is up, so the app keeps trying: every minute for half an hour, then every five minutes.
- The app starts when the Pi’s desktop does, so Desktop Auto Login has to be on. It is unless you changed it: Raspberry Pi menu → Preferences → Control Centre → System.
The app can’t find your unit
- Use a data cable. A charge-only cable looks the same and carries no data.
- Only one program can use the unit’s USB at a time. Run one copy of Fractal Remote on the Pi: the AppImage, not the .deb as well.
- Turn the unit off and on again with the app running.
More is on the support page.
For gigs
-
The Pi needs the internet. Your phone’s hotspot is the surest: add it once
at home, and the Pi joins it by itself at every gig. To add it, switch the hotspot on, then
on the Pi’s desktop (through Connect, or with a screen) click the network icon at the top
right, choose the hotspot and type its password. The Pi remembers it. A network cable into
the venue’s router works too. A venue’s wifi works only if the Pi has joined it before,
from its desktop, and never if it has a sign-in page.
- iPhone: open Settings → Personal Hotspot, switch on Allow Others to Join, and keep that screen open until the Pi has joined, at home and at the gig. With a Pi 3 Model B, also switch on Maximize Compatibility there (iPhone 12 or later; older iPhones already use 2.4 GHz).
- Android phone with a Pi 3 Model B: set the hotspot to 2.4 GHz in its settings. Some phones call that AP band, or Extend compatibility.
- It needs a wall socket. Plug its own power supply into the wall or a power strip, not into a USB socket on a pedal power supply or a power bank, which may not give it enough.
-
Shut it down before you unplug it, when you can. Pulling the plug on a
running Pi can, now and then, spoil the memory card.
- Pi 5: press its power button twice, quickly. Wait a few seconds, then unplug it.
- Pi 4, Pi 3 and the keyboard ones: on the Pi’s desktop, Raspberry Pi menu → Shutdown → Shutdown, then unplug it. With no screen, open the desktop through Connect, if it is switched on; that works in your phone’s web browser too. (On a Pi 400, Fn and F10 together open the same Shutdown window; on a Pi 500 or 500+, the power key does.)
- Switch it on in good time, before you need it. A Pi 3 most of all can take several minutes before the phone finds it.