← Back to Blog

How to Set Up SSH on a Raspberry Pi for Codeusse

guidesshraspberry-pi

Want to code on your Raspberry Pi from your phone? With Codeusse’s SSH support and Raspberry Pi OS’s SSH server, you can connect from anywhere on your local network and work in a full Linux environment. Here’s how to set it up — from imaging the SD card to your first connection.

What You’ll Need

  • A Raspberry Pi and a compatible microSD card (and a reader on your computer)
  • A Mac or PC with Raspberry Pi Imager installed
  • Your Pi and your mobile device connected to the same Wi-Fi network (or Ethernet on the same LAN)
  • Codeusse installed on your phone or tablet

Download on the App Store

Step 1: Install Raspberry Pi Imager

Download Raspberry Pi Imager from the official Raspberry Pi software page and install it on your computer. You’ll use it to write Raspberry Pi OS to the microSD card and to pre-configure SSH and your login before the Pi ever boots.

Step 2: Choose an OS and Customize

  1. Insert your microSD card and open Raspberry Pi Imager.
  2. Pick your device:

Welcome screen of Raspberry Pi Imager

Click Next.

  1. Pick a Raspberry Pi OS image (for example Raspberry Pi OS (64-bit) or Raspberry Pi OS Lite (64-bit) if you want a minimal system without a desktop).

OS Image picker, selected Raspberry Pi OS OS Image picker, selected (other) OS Image picker, selected Raspberry Pi OS

Click Next.

  1. Click Choose Storage and select your microSD card.

Storage Picker

Click Next.

Step 3: Apply Customization

Most of the settings should be configured by yourself. The guide will show you all of the customization screens with notes, on which settings will be relevant to the next steps of making Codeusse able to connect to your Pi.

You can use the fields below to store the input you provided to your Pi, so the guide can be customized to your settings in the next steps. The values will not leave your device, and will be stored only in your browser.

Hostname customization Locale customization User account Network settings SSH settings


Step 4: Write Image

Click Write to flash the card. Wait until the write and verify steps finish, then eject the card safely.

Raspberry Pi Imager write summary showing OS, storage, and customization before writing Raspberry Pi Imager writing the image to the microSD card with progress Raspberry Pi Imager verifying the written image on the microSD card Raspberry Pi Imager applying OS customizations during the write process Raspberry Pi Imager showing write complete after a successful flash and verify

Step 4: First Boot

  1. Put the microSD card into your Raspberry Pi and power it on.
  2. Give it a minute or two on first boot (especially if it’s expanding the filesystem or updating).
  3. Confirm your Pi is on the same network as your phone (same Wi-Fi SSID, or same LAN if using Ethernet).

Step 5: Find Your Raspberry Pi’s Local IP Address

To connect from Codeusse, you need your Pi’s IP address on the local network (it usually looks like 192.168.x.x or 10.0.x.x).

Option A: Try the .local Hostname First

If you set a hostname in Imager (for example raspberrypi), try resolving it with mDNS:

  • raspberrypi.local (replace with your hostname)

The default image often uses raspberrypi as the hostname, so raspberrypi.local may work if you didn’t change it. You can test from a computer on the same network:

ping -c 3 raspberrypi.local

If ping works, you can use raspberrypi.local (or your-hostname.local) as the Host in Codeusse instead of the numeric IP.

Option B: Your Router’s Admin Page

Log in to your Wi-Fi router’s admin interface (often printed on the router or documented in its manual). Look for DHCP client list, connected devices, or LAN status. Find the device named like your Pi’s hostname or “raspberrypi” and note its IP address.

Option C: From the Mac Terminal (ARP Scan)

After the Pi has been on for a minute, your Mac’s ARP table may list it. This is quick but not always labeled clearly:

arp -a | grep -i "192.168\|10.0"

Compare with devices you know, or cross-check with the router list.

Option D: If You Have a Monitor and Keyboard Attached

On the Pi itself, run:

hostname -I

The first address is typically your Pi’s LAN IP.

Tip: Local IP addresses can change when the router assigns them via DHCP. If your Pi’s IP keeps moving, set a DHCP reservation or static IP for the Pi in your router’s settings.

Write down the IP (or your working hostname.local) — you’ll need it in the next step.

If you already know your Pi’s IP address, you can enter it below so the connection details in Step 6 match what you found:

Step 6: Connect from Codeusse

Open Codeusse on your phone or tablet and create a new SSH connection with these details:

  • Host: Your Pi’s IP address (e.g. 192.168.1.50) or raspberrypi.local if mDNS works on your network
  • Port: 22 (the default)
  • Username: The username you set in Raspberry Pi Imager (Step 3), e.g. pi
  • Authentication: Password — use the same password you configured in Imager (not your Wi-Fi password), e.g. your SSH password

Codeusse SSH connection screen with host, port, and username fields filled in for Raspberry Pi

Tap Save. Then tap the newly created connection to open a session on your Pi.

iOS will ask for Local Network access. The first time you connect, iOS may ask whether Codeusse can access devices on your local network. Tap Allow — this permission is required for Codeusse to reach your Pi over Wi-Fi. Without it, the connection will fail.

You now have an active SSH session on your Raspberry Pi. You can install tools, edit files, run services, and use the same workflows you’d use from a desktop terminal.

Troubleshooting

”Connection refused” error

  • Confirm SSH was enabled in Raspberry Pi Imager before writing the card (Step 3).
  • Make sure the Pi finished booting and is online (LED activity, or try ping to its IP).
  • Double-check the IP address or hostname.local — typos are common.

”Connection timed out” error

  • Ensure your phone and the Pi are on the same network (same SSID for Wi-Fi; or same LAN segment for Ethernet).
  • If you use a guest Wi-Fi network, many routers isolate clients from each other — use the main LAN Wi-Fi or adjust router settings.
  • Some routers or firewalls block device-to-device traffic; check AP isolation / client isolation is off.

”Permission denied” error

  • Verify the username and password match what you set in OS customization in Imager (not your Apple ID or router password).
  • If you only enabled public key authentication in Imager, password login will fail — re-flash with password authentication or add your key.

hostname.local Does Not Resolve

  • Not all networks forward mDNS reliably. Fall back to the numeric IP from your router or hostname -I on the Pi.

What’s Next?

Once you’re connected over SSH, you can:

  • Edit files on your Pi using Codeusse’s editor
  • Run development servers and reach them from your mobile browser (using the Pi’s IP and the right port)
  • Use Git, package managers, and your usual Linux tooling
  • Set up SSH keys so you don’t have to type your password each time

Have questions or ran into an issue? Drop by our Reddit community — we’re happy to help.