sodcalculator

10 Tech How-To

How to Install Spotify on Linux: Step-by-Step

Guide 10-36663 · Updated · Step by step

Spotify is one of the most popular music streaming services, and while it doesn’t offer an official Linux build from its website, it does provide a dedicated Linux client through its own repository. This guide walks you through installing Spotify on any major Linux distribution, covering both Debian/Ubuntu and Fedora/RHEL families, plus a universal Flatpak method. By the end, you’ll have the native Spotify app installed, with automatic updates and a desktop launcher.

What You’ll Need

  • A Linux distribution (Ubuntu, Debian, Fedora, Arch, or any distro that supports Flatpak)
  • An active internet connection
  • Terminal access (you’ll run a few commands)
  • A Spotify account (free or premium) – you can sign up after installation

Step-by-Step

For Debian/Ubuntu and derivatives (using the official repository)

  1. Open a terminal (Ctrl+Alt+T on most systems).
  2. Add Spotify’s GPG key by running:
    curl -sS https://download.spotify.com/debian/pubkey_6224F9941A8AA6D1.gpg | sudo gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/spotify.gpg

    If curl is not installed, install it with sudo apt install curl first.

  3. Add the Spotify repository to your sources list:
    echo "deb http://repository.spotify.com stable non-free" | sudo tee /etc/apt/sources.list.d/spotify.list
  4. Update your package list: sudo apt update
  5. Install Spotify: sudo apt install spotify-client
  6. Launch Spotify from your application menu, or type spotify in the terminal.

For Fedora/RHEL and derivatives (using the official repository)

  1. Open a terminal.
  2. Add the Spotify repository by running:
    sudo dnf config-manager --add-repo=https://repository.spotify.com/rpm/stable/non-free/x86_64/

    If dnf config-manager is not available, install it with sudo dnf install dnf-plugins-core.

  3. Add Spotify’s GPG key: sudo rpm --import https://download.spotify.com/debian/pubkey_6224F9941A8AA6D1.gpg
  4. Install Spotify: sudo dnf install spotify-client
  5. Launch from the app menu or run spotify.

For any distribution using Flatpak (universal method)

  1. Ensure Flatpak is installed. If not, install it with your package manager (e.g., sudo apt install flatpak on Ubuntu, sudo dnf install flatpak on Fedora).
  2. Add the Flathub repository if you haven’t already:
    flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
  3. Install Spotify from Flathub:
    flatpak install flathub com.spotify.Client
  4. Run Spotify with flatpak run com.spotify.Client, or find it in your application menu.

For Arch Linux (AUR)

  1. If you use an AUR helper like yay, run:
    yay -S spotify
  2. If you don’t, clone the AUR package and build it manually:
    git clone https://aur.archlinux.org/spotify.git
    cd spotify
    makepkg -si

Common Mistakes

  • Using the wrong repository URL – For Debian, the repository line must be exactly deb http://repository.spotify.com stable non-free. A common typo is using main instead of non-free, which causes a “404 Not Found” error during update.
  • Forgetting to import the GPG key – If you skip the key import, apt or dnf will refuse to use the repository with a “public key not available” error.
  • Using the Flatpak method on a system without Flatpak – Some minimal installations don’t have Flatpak by default. Install it first, otherwise the flatpak command won’t be found.
  • Mixing repository methods – Don’t install via the Debian repo and then try to update via Flatpak; they are separate packages and may conflict.

Tips

  • After installing via the official repository, Spotify updates automatically with your system’s package manager (apt or dnf). No need to manually reinstall.
  • If you prefer a sandboxed app, the Flatpak version is a good choice because it isolates Spotify from the rest of your system.
  • To enable hardware acceleration for smoother visuals, you can add the --enable-features=VaapiVideoDecoder flag when launching Spotify from the terminal, but this is optional and may not work on all GPUs.
  • If you have a HiDPI display, you can adjust the scaling in Spotify’s settings under “Display” – it usually detects automatically, but you can fine-tune it.

Troubleshooting

  • “404 Not Found” when running sudo apt update – This usually means the repository URL is wrong. Double-check the line in /etc/apt/sources.list.d/spotify.list. It should be exactly deb http://repository.spotify.com stable non-free.
  • “GPG error: The following signatures couldn’t be verified” – Re-import the GPG key using the command in Step 2. If that fails, try removing the old key with sudo rm /etc/apt/trusted.gpg.d/spotify.gpg and then re-import.
  • Spotify won’t launch after installation – Run spotify from the terminal to see any error messages. A common issue is missing GPU drivers; try installing the latest graphics drivers for your system. For Flatpak, run flatpak run com.spotify.Client to get error output.
  • No sound or audio issues – Check your system’s sound settings. Spotify uses PulseAudio or PipeWire; if you’re on a minimal system, install pulseaudio or pipewire. Also, ensure your audio device isn’t muted.
  • Spotify is not in the application menu – After installation, log out and log back in, or restart your desktop environment. Sometimes the menu cache needs to refresh.

Frequently Asked Questions

Is Spotify officially supported on Linux?

Spotify provides an official Linux client, but it’s not heavily advertised. They maintain repositories for Debian/Ubuntu and Fedora, and the client is updated regularly. However, support is community-driven to a degree, and some features may lag behind Windows/macOS versions.

Can I install Spotify without using the terminal?

Yes, you can use a graphical package manager like Ubuntu Software Center, but you’ll need to add the repository first. The easiest terminal-free method is to use the Flatpak version from Flathub, which can be installed via the GNOME Software app if you have Flatpak integration enabled.

Will Spotify work on my Raspberry Pi (ARM)?

The official repository only provides x86_64 packages. For ARM devices like Raspberry Pi, you can use the Flatpak version (if available for ARM) or use a third-party client like librespot or the web player. The web player works on any device with a browser.

How do I update Spotify on Linux?

If you installed via the official repository, simply run your system’s update command (sudo apt update && sudo apt upgrade or sudo dnf update). For Flatpak, run flatpak update. Updates are automatic if you have automatic updates enabled.

Can I use Spotify on Linux with a free account?

Yes, the client works with free accounts, but you’ll hear ads and have limited skips, just like on other platforms. The installation process is the same regardless of account type.

Why does Spotify look different on Linux compared to Windows?

The Linux client may have a slightly different UI due to the GTK/Qt integration, but it’s essentially the same app. Some features like hardware acceleration might be disabled by default, but you can enable them in the client’s settings or via launch flags.

Related

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →