> For the complete documentation index, see [llms.txt](https://docs.theseus.us/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.theseus.us/cyclops/cyclops-computer/example-pi-5-setup/ubuntu-and-sd-card-setup.md).

# Ubuntu and SD Card setup

Before installing Cyclops you will need to flash an OS image and set up SSH on your Pi 5. This will prepare the computer for all installations and configurations in the rest of the setup process.

{% stepper %}
{% step %}

### Install Ubuntu 24

We use **Raspberry Pi Imager** to flash on OS your micro SD card.

(download for [Linux](https://downloads.raspberrypi.com/imager/imager_latest_amd64.AppImage) or [Windows](https://downloads.raspberrypi.com/imager/imager_latest.exe))

We will use **Ubuntu 24.04 Server,** as it is more lightweight than the Desktop version.

Connect the SD card to your host computer with Raspberry Pi Imager, select the OS for the Pi 5, the SD card as the storage, and flash the Ubuntu Server 24.04 OS onto the SD card.

When prompted for OS customization, press No, as the following step will automatically setup the SD card for this.
{% endstep %}

{% step %}

### Run the SD card Setup Script

To save time if you are using a Raspberry Pi 5 with Ubuntu Server 24.04, we recommend using this setup script after flashing the boot SD card. The script will apply some default configurations so you don't need to manually setup the serial port.

This runs on your Ubuntu Linux host, against a freshly flashed Ubuntu Server 24.04, before the Pi's first boot.

{% file src="/files/DImsDcyR7cL3AaxQrBDp" %}

On first boot, `cloud-init` will:

* Set hostname: `clop-$DEVICE_NUM`
* Create user 'pi' (password: pi, sudo)
* Enable SSH with password auth
* Set static IP: `192.168.218.100`
* Create `/home/pi/recordings`
* Disable EEE on eth0 (Pi 5 link-flap fix)
* Setup Pi serial port
* Reboot to apply boot config changes

Run this command from your host (the mount path may differ):

```bash
sudo apt-get install device-tree-compiler
bash setup-sd-card.sh -n 1 /media/$USER/system-boot
```

{% hint style="info" %}
The number after "-n" specifies the device number.
{% endhint %}

This step only configures Ubuntu, to finish installing Cyclops, see [vns-sdk setup](/cyclops/cyclops-computer/example-pi-5-setup/vns-sdk-setup.md).

After the script has run, insert the SD card into the Pi, connect the Pi to power and wait for it to boot. You can now connect over SSH via an Ethernet cable with the command below. The username and password are bot "pi" by default.

```bash
ssh pi@192.168.218.100
```

{% endstep %}
{% endstepper %}