5UBZERO664 Logo
Back to Blog
February 22, 2026

Casa OS on Orange Pi 5. M.2 NVME SSD. Network Attached Storage with user friendly UI

Installing Casa OS, Debian Bullseye on the Orange Pi 5. Fixing and running App Store. Installing Jellyfin Media Server on Casa OS.Use a USB to nvme m.2 ada...

here's a blog post based on the YouTube video content you provided, formatted for GitHub-flavored Markdown.

Turn Your Orange Pi 5 into a Powerful Home Cloud with CasaOS and Debian

In this guide, we'll walk you through turning an Orange Pi 5 single-board computer into a full-fledged home cloud server. We'll be using Debian Bullseye as the base operating system and CasaOS as the user-friendly interface on top. CasaOS is going to make managing all your home server needs way easier! We'll also tackle a common issue: getting the app store working correctly. Finally, we will set up Jellyfin, a popular media server. So, grab your Orange Pi 5 and let's dive in!

Getting Started with Orange Pi 5 and Debian Bullseye

First, you'll need to download the Debian Bullseye server image from the Orange Pi website. This will be the foundation of our home cloud. The video suggests using the server version of Debian as it doesn't include a desktop environment, saving resources since CasaOS provides the GUI we'll be using.

Before flashing the image to a storage device, make sure to extract the .img file from the downloaded archive. Balena Etcher is used to flash the image onto a microSD card.

balenaEtcher /path/to/debian_bullseye.img /dev/sdX

It is important to select the extracted image and not the zipped folder itself!

Booting into Your New System

Once the image is flashed, insert the microSD card into your Orange Pi 5 and boot it up. To interact with the system initially, you will need an SSH client. The default username is "orangepi" and password is also "orangepi".

After logging in, be sure to update and upgrade your system:

sudo apt update
sudo apt upgrade -y

This ensures you have the latest software packages and security updates. It's best practice to always do this before installing any new software.

Setting Up NVMe Boot (Optional but Recommended!)

To improve performance, you can boot your Orange Pi 5 directly from an NVMe SSD. The presenter used a 256GB m.2 NVMe. In a terminal window:

sudo orangeepi-config

In the menu that pops up, select System, select Install, and then Install/Update the Bootloader on the SPI Flash. After that you will be able to boot directly from the installed SSD. Once this has completed, you can shut down the system and remove the MicroSD card and it will boot automatically from the NVMe drive instead of booting from the Micro SD card. This results in better read/write speeds and makes for a smoother system.

Installing CasaOS

Now it's time to install CasaOS. Go to the CasaOS website to get the installation command. The installation command is usually something along the lines of:

curl -fsSL https://get.casaos.io | sudo bash

This command downloads and executes a script that automates the installation of CasaOS. After running that script you should have Casa OS running on the pi5. The IP address and port will be displayed on screen.

Fixing a Common App Store Issue

A common problem users encounter is that the app store within CasaOS may not load correctly after installation. This is usually resolved by getting the authorization key from the system configuration:

  1. SSH into your Orange Pi 5.
  2. Run this cURL command to check whether AppStore API returns the App catalog: 
    curl https://api.casaos.io/casasos-api/api/token
    If successful, a JSON payload like this will be returned:
{
"code":200,
"message": "ok",
"data": eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJlYXQiOjE2ODA0NzU3MzcsImlzcyI6ImNhc2FvcyIsIm5iZiI6MTY3MjcwNzEzNywic3ViIjoiYWRtaW4ifQ.EmzTSvuulI2MdziVXw24Sa5tw-ydwtuHgESb6S7TlfjM"
}
  1. Copy the token in data above and replace the <token> below with it.
  2. Run the following command: 
    curl https://api.casaos.io/casasos-api/v2/app/newlist \
  -H "Authorization: <token>"

That process pulls the API token and fixes the app store by clearing the cache!

Setting Up Jellyfin Media Server on CasaOS

Jellyfin is a free software media system, putting you in control of managing and streaming your media.

  1. Navigate to the App Store inside the CasaOS interface.
  2. Search for "Jellyfin".
  3. Click "Install." CasaOS handles the rest!

Once Jellyfin is installed, follow the setup wizard within the Jellyfin interface to configure your media libraries, users, etc.

Adding the Heat Sink

To finish out, and ensure the pi5 runs optimally, you need to add a heat sink.

Key Takeaways

  • The Orange Pi 5 can be turned into a powerful home cloud server with the right OS.
  • CasaOS provides a user-friendly interface for managing Docker containers and various home server applications.
  • Booting from an NVMe SSD significantly improves the speed and performance.
  • The CasaOS app store can sometimes have issues loading; the fix involves obtaining a new token and running a specific command.
  • Jellyfin simplifies building your own media streaming server on top of CasaOS.

Resources

All Articles