📦 Using TunaOS Flatpaks

TunaOS publishes its Flatpak applications through a custom OCI remote. Each app runs in a sandbox, updates itself automatically, and targets the GNOME desktop.

What's Available

App	Description	Flatpak ID	Source
Tables 📊	Pure Rust GTK4 spreadsheet	`org.tunaos.tables`	GitHub
Decks 📽️	Pure Rust GTK4 presentation app	`org.tunaos.decks`	GitHub
Letters 📝	Pure Rust GTK4 word processor	`org.tunaos.letters`	GitHub
Tavern 🍺	Homebrew GUI client	`dev.hanthor.Tavern`	GitHub

Adding the Remote

One-time setup

flatpak remote-add --if-not-exists tuna-os https://tunaos.org/flatpak/tuna-os.flatpakrepo

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

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

Problem	Fix
`Remote \"tuna-os\" not found`	Add the remote first: `flatpak remote-add --if-not-exists tuna-os https://tunaos.org/flatpak/tuna-os.flatpakrepo`
App won't launch	Try `flatpak run org.tunaos.tables --log-level=debug`
Update fails	Run `flatpak repair` then `flatpak update`
Permission denied	Flatpaks are sandboxed. Use Flatseal to manage permissions

What's Available​

Adding the Remote​

One-time setup​

Verify the remote​

Installing Apps​

CLI installation​

GUI installation​

Managing Apps​

Update all Flatpaks​

List installed Flatpaks​

Remove an app​

Check for updates​

Troubleshooting​

See Also​