Skip to main content

📦 Using TunaOS Flatpaks

TunaOS publishes Flatpak applications through a custom OCI remote, providing sandboxed, auto-updating apps for the GNOME desktop.

What's Available​

AppDescriptionFlatpak IDSource
Tables 📊Spreadsheet app (400+ functions)org.tunaos.tablesGitHub
Decks 📽️Presentation apporg.tunaos.decksGitHub
Letters 📝Word processororg.tunaos.lettersGitHub
Tavern 🍺Homebrew GUI clientdev.hanthor.TavernGitHub

Rust Previews (lighter, faster)​

Native GTK4 Rust rewrites are available with a -rust suffix:

flatpak install tuna-os org.tunaos.tables-rust
flatpak install tuna-os org.tunaos.decks-rust
flatpak install tuna-os org.tunaos.letters-rust

Adding the Remote​

One-time setup​

flatpak remote-add tuna-os https://docs.tuna-os.org/flatpak/tuna-os.flatpakrepo

Or via the OCI registry directly:

flatpak remote-add --if-not-exists tuna-os oci+https://tuna-os.github.io/flatpak-index

Verify the remote​

flatpak remotes | grep tuna-os

Installing Apps​

CLI installation​

# Single app
flatpak install tuna-os org.tunaos.tables

# Multiple apps at once
flatpak install tuna-os org.tunaos.tables org.tunaos.decks org.tunaos.letters

# Rust preview
flatpak install tuna-os org.tunaos.tables-rust

GUI installation​

Open GNOME Software or KDE Discover — after adding the remote, TunaOS apps appear in the app list for one-click installation.

Managing Apps​

Update all Flatpaks​

flatpak update

List installed Flatpaks​

flatpak list --app

Remove an app​

flatpak uninstall org.tunaos.tables

Check for updates​

flatpak update --check

Troubleshooting​

ProblemFix
Remote \"tuna-os\" not foundAdd the remote first: flatpak remote-add tuna-os https://docs.tuna-os.org/flatpak/tuna-os.flatpakrepo
App won't launchTry flatpak run org.tunaos.tables --log-level=debug
Update failsRun flatpak repair then flatpak update
Permission deniedFlatpaks are sandboxed. Use Flatseal to manage permissions

See Also​