Skip to content

Install Stremio on Linux

15 minModerate

What You’ll Do

Install Stremio using your preferred method: AppImage (universal), Flatpak, or distribution package.


Before You Begin

  • Confirm architecture: Official builds target 64-bit x86 (amd64). For ARM boards such as Raspberry Pi, use the web version or community builds.
  • Update your distro: Run your package manager’s update command (sudo apt update && sudo apt upgrade, sudo dnf upgrade, etc.) to avoid dependency conflicts.
  • Check GPU drivers: Hardware acceleration depends on up-to-date Mesa (Intel/AMD) or NVIDIA drivers. If videos tear or lag, install proper drivers first.
  • Pick an install location: Many users keep AppImages in ~/Applications so they survive distro upgrades.

Which Method Should I Use?

MethodBest forUpdatesHighlights
AppImageUsers who want a portable binaryManual (download new file)Works everywhere, no root needed, easy to carry on USB drive.
FlatpakFedora/Silverblue, immutable distros, sandboxing fansflatpak updateRuns in a sandbox, integrates with GNOME Software/KDE Discover.
Distribution packageDebian/Ubuntu, RPM, Arch users who prefer native packagesManaged by system package managerIntegrates with system menu/services, but requires replacing versioned URLs manually.

Pros: Universal, no installation, works on any distro
Cons: Requires manual updates, no system integration

Steps

  1. Download the AppImage

    Terminal window
    wget https://www.stremio.com/download/linux/appimage -O Stremio.AppImage

    Optional: Verify the SHA-256 checksum published on stremio.com/downloads before running the file.

  2. Make it executable

    Terminal window
    chmod +x Stremio.AppImage
  3. Run Stremio

    Terminal window
    ./Stremio.AppImage
  4. Optional: Add to menu (varies by desktop environment)

Tip

Install appimagelauncher (available in most repositories) if you want automatic menu entries and desktop integration for AppImages.


Method 2: Flatpak

Pros: Sandboxed, auto-updates, available on Flathub
Cons: Requires Flatpak runtime

Steps

  1. Install Flatpak (if not already installed)

    Terminal window
    sudo apt install flatpak # Debian/Ubuntu
    sudo dnf install flatpak # Fedora
  2. Add Flathub repository

    Terminal window
    flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  3. Install Stremio

    Terminal window
    flatpak install flathub com.stremio.Stremio
  4. Run Stremio

    Terminal window
    flatpak run com.stremio.Stremio
Note

On Steam Deck, ChimeraOS, or other immutable distros, Flatpak is the most reliable option—just enable Developer Mode or Desktop Mode to run the commands above.


Method 3: Distribution Packages

Ubuntu/Debian

Terminal window
wget https://dl.strem.io/linux/v4.4.168/stremio_4.4.168-1_amd64.deb
sudo dpkg -i stremio_*.deb
sudo apt-get install -f # Fix dependencies

Fedora

Terminal window
sudo dnf install https://dl.strem.io/linux/v4.4.168/stremio-4.4.168-1.x86_64.rpm

Arch Linux (AUR)

Terminal window
yay -S stremio
# or
paru -S stremio
Note

Version numbers in URLs will change. Check stremio.com for the latest version.


Keep Stremio Updated

  • AppImage: Download the newest AppImage, mark as executable, then delete the old file so you don’t launch the wrong version.
  • Flatpak: flatpak update com.stremio.Stremio (or click “Update” in GNOME Software/KDE Discover).
  • Deb/RPM: Re-run the wget + install commands with the latest version number. Pinning the old file will leave you without bug fixes.
  • AUR: Use your helper (yay -Syu, paru -Syu) so the package rebuilds when the maintainer bumps the version.
Warning

Stremio does not auto-update on Linux outside of Flatpak. Running outdated builds can break login/authentication once the API changes upstream.


Uninstalling

  • AppImage: Delete the .AppImage file. If you used AppImageLauncher, also remove ~/.local/share/applications/stremio.desktop.
  • Flatpak: flatpak uninstall com.stremio.Stremio.
  • Debian/Ubuntu: sudo apt remove stremio && sudo apt autoremove.
  • Fedora/RHEL: sudo dnf remove stremio.
  • AUR: yay -Rns stremio (or the helper you used).

Reset user data: remove ~/.config/Stremio (AppImage/native) or ~/.var/app/com.stremio.Stremio (Flatpak) to wipe cache, add-ons, and settings.


Where Stremio Stores Files

WhatPath
Config, cache, add-ons (AppImage/native)~/.config/Stremio
Flatpak sandbox data~/.var/app/com.stremio.Stremio
Desktop entries~/.local/share/applications/stremio.desktop

Knowing these paths makes it easy to back up your library or migrate to another device.


Troubleshooting

Missing dependencies

Install required libraries:

Terminal window
# Ubuntu/Debian
sudo apt install libmpv1 libqt5webengine5
# Fedora
sudo dnf install mpv qt5-qtwebengine

Won’t launch

Try from terminal to see error messages:

Terminal window
stremio
# or for AppImage
./Stremio.AppImage

If you see Qt platform errors on Wayland desktops, force X11 fallback:

Terminal window
QT_QPA_PLATFORM=xcb ./Stremio.AppImage

For blurry fonts on HiDPI displays, export QT_SCALE_FACTOR=1.5 (adjust value) before launching.

Video artifacts or black screen

  • Install mesa-va-drivers mesa-vdpau-drivers (Intel/AMD) or proprietary NVIDIA drivers.
  • Toggle Settings → Player → Hardware Acceleration off/on.
  • For Flatpak builds, allow GPU access: flatpak override --user --filesystem=home --device=dri com.stremio.Stremio.

Can’t write cache

If you moved the AppImage to a read-only location, Stremio may fail to write into ~/.config/Stremio. Ensure you have permission to that folder or set the STREMIO_RUNTIME_DIR environment variable to a writable path.


Next Steps

Continue to First 10 Minutes Setup.