Установка Flatpak на Debian 13, 12, 11: подробное руководство

Flatpak — это система для запуска приложений в изолированной среде (песочнице). Она позволяет устанавливать свежие версии программ, не опасаясь конфликтов с системными библиотеками Debian. Flatpak особенно полезен, когда вам нужна последняя версия приложения, а в стандартных репозиториях Debian она устарела.

💡 В Debian Flatpak уже есть в стандартных репозиториях — вам не нужно добавлять сторонние источники. Достаточно установить пакет одной командой, добавить репозиторий Flathub (основной источник приложений) и можно устанавливать любые программы: от GIMP до Discord.

Какой вариант выбрать?

  • Домашний ПК (один пользователь): ставьте Flatpak без sudo (--user) и используйте Flatseal для управления разрешениями.
  • Рабочая станция (несколько пользователей): системная установка (--system) и централизованное управление.
  • Сервер без графики: Flatpak можно использовать для headless-задач, но графический магазин приложений и порталы не нужны.

В этой статье вы узнаете:

  • Как установить Flatpak на Debian
  • Как добавить репозиторий Flathub
  • Как устанавливать, обновлять и удалять приложения через терминал
  • Как установить приложение из файла .flatpakref
  • Как настроить GNOME Software или KDE Discover для работы с Flatpak
  • Как управлять разрешениями Flatpak-приложений
  • Как решить типичные проблемы (порталы, разрешения, отсутствие в меню)
  • Как полностью удалить Flatpak с системой

Для кого: новички в Debian (хотят устанавливать современные приложения), сисадмины (развёртывание Flatpak на рабочих станциях), пользователи Debian 11, 12 и 13.

Оглавление

Оглавление

1. 🔧 Предварительные требования

Перед установкой убедитесь, что:

  • У вас установлена Debian 11, 12 или 13 (любая редакция)
  • Подключение к интернету стабильно
  • У вас есть хотя бы 500 МБ свободного места (Flatpak и первые приложения займут место)

⚠️ ВАЖНО: Проверьте права sudo перед установкой

Если вы не уверены, есть ли у вашего пользователя права администратора, выполните в терминале:

sudo -l

Что делает: Проверяет, есть ли у текущего пользователя права суперпользователя.

⚠️ Пароль при первом запуске! В зависимости от настроек в /etc/sudoers, при первом выполнении sudo -l в текущей сессии система может запросить ваш пароль (если не активировано правило NOPASSWD).

✅ Ожидаемый результат: Список разрешённых команд. Если видите (ALL : ALL) ALL — у вас полный доступ.

❌ Если видите ошибку user is not in the sudoers file или may not run sudo — сначала пройдите наше руководство по настройке sudo. Без этого дальнейшие шаги не сработают.

2. 📦 Установка Flatpak на Debian

Flatpak включён в стандартные репозитории Debian, но в минимальных или серверных установках он может отсутствовать.

2.1 Обновление системы

Перед установкой всегда обновляйте список пакетов:

sudo apt update
sudo apt upgrade

Что делает:

  • sudo — права суперпользователя
  • apt update — обновляет список доступных пакетов
  • apt upgrade — обновляет все установленные пакеты

Зачем: Это стандартная практика безопасности перед установкой нового ПО.

💡 Примечание: Флаг -y автоматически подтверждает все действия. В обучающих инструкциях его лучше не использовать: так вы видите список пакетов и можете отменить установку, если что-то выглядит подозрительно. Если вы уверены в своих действиях, можно добавить -y.

2.2 Установка Flatpak

sudo apt install flatpak

Что делает: Устанавливает пакет Flatpak из официальных репозиториев Debian.

Зачем: Flatpak отсутствует в минимальных установках, поэтому его нужно установить вручную.

2.3 Проверка установки

flatpak --version

✅ Ожидаемый вывод в терминале:

Для Debian 13 (Trixie):

Flatpak 1.16.6

Для Debian 12 (Bookworm):

Flatpak 1.14.4

Для Debian 11 (Bullseye):

Flatpak 1.10.8

(Версия зависит от вашего выпуска Debian)

3. 🗃️ Добавление репозитория Flathub

Flathub — это основной и самый крупный репозиторий Flatpak-приложений. Без него вы не сможете устанавливать программы.

3.1 Добавление репозитория (системно)

sudo flatpak remote-add --system --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Что делает:

  • flatpak remote-add — добавляет удалённый репозиторий
  • --system — делает репозиторий доступным для всех пользователей системы
  • --if-not-exists — не создаёт дубликат, если репозиторий уже добавлен
  • flathub — имя репозитория
  • https://dl.flathub.org/repo/flathub.flatpakrepo — адрес официального репозитория Flathub

Зачем: Flathub содержит тысячи приложений — от офисных пакетов до игр. Без него Flatpak бесполезен.

3.2 Проверка добавления репозитория

flatpak remotes --system

✅ Ожидаемый вывод в терминале:

Name    Options
flathub system,download,oci

Если вы видите flathub в выводе — репозиторий добавлен успешно.

4. 🔄 Применение настроек рабочего стола

Flatpak добавляет ярлыки приложений в стандартные директории XDG. Чтобы они появились в меню, нужно перезагрузить сессию.

Вариант 1 (рекомендуемый): Выйдите из системы и зайдите снова.

Вариант 2: Если перелогин не помог, перезагрузите компьютер:

sudo reboot

💡 Для серверов без графики: Этот шаг можно пропустить — Flatpak работает и без меню, через терминал.

5. 🖥️ Графическая установка приложений (опционально)

Если вы используете GNOME или KDE, можно установить плагины для магазинов приложений.

5.1 Для GNOME Software

Установите плагин, чтобы GNOME Software показывал приложения из Flathub:

sudo apt install gnome-software-plugin-flatpak

Что делает: Плагин интегрирует Flathub в GNOME Software.

Зачем: После этого вы сможете искать, устанавливать и обновлять Flatpak-приложения прямо из графического магазина.

После установки плагина перезапустите GNOME Software (закройте программу «Магазин приложений» и откройте снова) или выйдите из системы и зайдите снова.

5.2 Для KDE Discover

Если вы используете KDE Plasma, установите бэкенд для Discover:

sudo apt install plasma-discover-backend-flatpak

Что делает: Добавляет поддержку Flatpak в KDE Discover.

Зачем: Discover сможет показывать и устанавливать приложения из Flathub наравне с пакетами Debian.

6. 📱 Управление Flatpak-приложениями из терминала

Терминал даёт полный контроль над Flatpak и работает в любом окружении.

⚠️ Важно про установку с sudo и без:

  • sudo flatpak install --system ... — устанавливается для всех пользователей системы (требует прав root).
  • flatpak install --user ... — только для текущего пользователя (не требует sudo).

Для домашнего ПК чаще удобнее --user, а на рабочих станциях с несколькими пользователями — --system.

6.1 Поиск приложений

flatpak search gimp

✅ Ожидаемый вывод в терминале:

GIMP User Manual                    GIMP User Manual                 org.gimp.GIMP.Manual    2.10    2.10    flathub
GNU Image Manipulation Program      Create images and edit photographs org.gimp.GIMP         3.0.8   stable  flathub
Resynthesizer                       Resynthesizer GIMP Plugin        org.gimp.GIMP.Plugin.Resynthesizer 3.0   3       flathub

Что делает: Ищет приложения по ключевому слову в Flathub.

Важно: Для установки нужен Application ID (третий столбец) — например, org.gimp.GIMP.

6.2 Просмотр информации о приложении

Перед установкой можно посмотреть подробности:

flatpak remote-info flathub org.gimp.GIMP

✅ Ожидаемый вывод в терминале:

GNU Image Manipulation Program - Create images and edit photographs

          ID: org.gimp.GIMP
         Ref: app/org.gimp.GIMP/x86_64/stable
        Arch: x86_64
      Branch: stable
      Version: 3.0.8
     License: GPL-3.0+ AND LGPL-3.0+
 Collection: org.flathub.Stable
     Runtime: org.gnome.Platform/x86_64/49

Показывает описание, версию, лицензию и требуемые зависимости.

6.3 Установка приложений

Системная установка (для всех пользователей, требует sudo):

sudo flatpak install --system flathub org.gimp.GIMP

Что делает: Устанавливает приложение для всех пользователей системы.

Пользовательская установка (только для текущего пользователя, без sudo):

flatpak install --user flathub org.gimp.GIMP

Во время установки система покажет, какие пакеты будут установлены, и запросит подтверждение. Внимательно просмотрите список — это хорошая практика безопасности.

6.4 Установка из файла .flatpakref

Некоторые приложения распространяются через файл .flatpakref (например, бета-версии или приложения, которых нет в Flathub). Этот файл содержит ссылку на репозиторий и идентификатор приложения.

⚠️ Предупреждение: Файлы .flatpakref могут быть загружены откуда угодно. Устанавливайте их только из доверенных источников.

Шаг 1: Скачайте файл .flatpakref с сайта разработчика (например, app.flatpakref) в папку ~/Downloads.

Шаг 2: Проверьте, что файл действительно скачан и находится в нужном месте:

ls -l ~/Downloads/app.flatpakref

Что делает: Показывает информацию о файле, если он существует.

✅ Ожидаемый вывод: Информация о файле (размер, дата, права доступа).

❌ Если выводит No such file or directory — значит, файла нет в этой папке или он называется иначе. Проверьте имя файла и путь к нему.

Шаг 3: Установите приложение из этого файла:

sudo flatpak install --from ~/Downloads/app.flatpakref

Что делает: Flatpak читает файл, подключает временный репозиторий (если нужно) и устанавливает приложение.

Для установки только текущему пользователю (без sudo):

flatpak install --user --from ~/Downloads/app.flatpakref

Шаг 4: Проверьте установку:

flatpak list --app --system --columns=application,origin,installation

Что ищем: В списке должно появиться установленное приложение.

После установки приложение можно обновлять и удалять обычными командами (flatpak update, flatpak uninstall), указывая его Application ID.

6.5 Список установленных приложений

flatpak list --app --system --columns=name,application,version,branch,installation

✅ Ожидаемый вывод в терминале:

GNU Image Manipulation Program    org.gimp.GIMP    3.0.8    stable    system

Что делает:

  • --app — показывает только приложения (без библиотек и рантаймов)
  • --system — системные установки
  • --columns — какие колонки показывать

6.6 Запуск приложений из терминала

flatpak run org.gimp.GIMP

Что делает: Запускает установленное приложение по его ID.

Зачем: Полезно для отладки или если приложение не появилось в меню.

6.7 Обновление приложений

Обновить все установленные Flatpak-приложения и рантаймы:

sudo flatpak update --system

Что делает: Проверяет наличие новых версий для всех системных Flatpak-пакетов и устанавливает их.

Обновить только одно приложение:

sudo flatpak update --system org.gimp.GIMP

💡 Примечание: Для пользовательских установок (--user) используйте те же команды без sudo, заменив --system на --user или опустив флаг.

6.8 Удаление приложений

sudo flatpak uninstall --system org.gimp.GIMP

Что делает: Удаляет указанное приложение.

Очистка неиспользуемых рантаймов (библиотек):

sudo flatpak uninstall --system --unused

Что делает: Удаляет рантаймы, которые больше не нужны ни одному установленному приложению, освобождая место на диске.

7. 🗂️ Где Flatpak хранит данные

Тип данныхРасположениеОписание
Системные приложения и рантаймы/var/lib/flatpak/Установленные программы и
библиотеки (для всех пользователей)
Пользовательские данные~/.var/app/<app-id>/Настройки, кэш, сохранения для
каждого приложения

Пример: Данные GIMP будут в ~/.var/app/org.gimp.GIMP/

💡 Важно: При полном удалении Flatpak эти директории не удаляются автоматически. Их нужно чистить вручную.

8. ⚠️ Решение типичных проблем

8.1 Flatpak search не возвращает результатов

Симптом:

No matches found
error: No remote refs found for 'flathub'

Причина: Локальные метаданные AppStream устарели или отсутствуют.

Пошаговое решение:

Шаг 1: Обновите метаданные Flathub:

sudo flatpak update --system --appstream

Что делает: Обновляет метаданные Flathub — это нужно, чтобы поиск и установка приложений работали корректно.

Шаг 2: Проверьте, что репозиторий Flathub добавлен:

flatpak remotes --system --columns=name

Убедитесь, что в выводе есть flathub.

Шаг 3: Повторите поиск:

flatpak search gimp

8.2 Приложение не появляется в меню Debian

Симптом: Flatpak установлен, но иконки нет в меню приложений.

Пошаговое решение:

Шаг 1: Проверьте, что приложение действительно установлено:

flatpak list --app --system --columns=name,application,version

Шаг 2: Запустите приложение из терминала, чтобы убедиться, что оно работает:

flatpak run org.gimp.GIMP

Шаг 3: Выйдите из системы и зайдите снова или перезагрузитесь:

sudo reboot

8.3 Ошибка порталов (XDG Desktop Portal)

Симптом: При запуске приложения ошибки вроде:

No portal found for org.freedesktop.portal.FileChooser
Failed to create portal proxy: No such interface

Причина: Отсутствует пакет xdg-desktop-portal для вашего окружения рабочего стола.

Пошаговое решение:

Шаг 1: Установите бэкенд портала для вашей среды рабочего стола.

Для GNOME и большинства окружений:

sudo apt install xdg-desktop-portal-gtk

Для KDE Plasma:

sudo apt install xdg-desktop-portal-kde

Шаг 2: Выйдите из системы и зайдите снова.

Шаг 3: Проверьте статус портала:

systemctl --user status xdg-desktop-portal

✅ Ожидаемый вывод: Active: active (running)

8.4 Ошибка доступа к файлам или устройствам

Симптом: Приложение не видит файлы в домашней директории или не может получить доступ к веб-камере.

Причина: Flatpak изолирует приложения в песочнице. По умолчанию доступ к файловой системе ограничен.

Пошаговое решение:

Шаг 1: Проверьте текущие разрешения приложения:

flatpak info --show-permissions org.gimp.GIMP

Что ищем: Строку filesystems — она показывает, к каким директориям у приложения есть доступ.

Шаг 2: Разрешите приложению доступ к домашней директории.

Для установки только текущего пользователя (без sudo):

flatpak override --user --filesystem=home org.gimp.GIMP

Для системной установки (для всех пользователей):

sudo flatpak override --system --filesystem=home org.gimp.GIMP

Что делает: Добавляет исключение для конкретного приложения.

⚠️ Предупреждение: Разрешение home открывает приложению доступ ко всем файлам в вашей домашней папке. Используйте его осознанно. Если нужно открыть только одну папку, лучше использовать --filesystem=/путь/к/папке.

Шаг 3: Проверьте, что разрешения применились:

flatpak info --show-permissions org.gimp.GIMP | grep filesystems

✅ Ожидаемый вывод: filesystems=home; или указанный путь.

Шаг 4 (если нужно вернуть всё как было): Сбросьте все пользовательские переопределения для приложения:

flatpak override --user --reset org.gimp.GIMP

Что делает: Удаляет все ранее добавленные разрешения для этого приложения, возвращая его к настройкам по умолчанию.

💡 Для графического управления разрешениями установите Flatseal:

sudo flatpak install flathub com.github.tchx84.Flatseal

8.5 Ошибка после обновления Debian

Симптом: После обновления Debian Flatpak приложения перестали запускаться.

Пошаговое решение:

Шаг 1: Обновите все Flatpak-рантаймы:

sudo flatpak update --system

Чаще всего проблема решается именно обновлением рантаймов.

Шаг 2: Если не помогло — переустановите проблемное приложение:

sudo flatpak uninstall --system org.gimp.GIMP
sudo flatpak install --system flathub org.gimp.GIMP

9. ❌ Полное удаление Flatpak

Если вы решили больше не использовать Flatpak, вот инструкция по полному удалению.

9.1 Удаление всех приложений

sudo flatpak uninstall --system --all

Что делает: Удаляет ВСЕ системные Flatpak-приложения и рантаймы. Подтвердите действие, когда система спросит.

9.2 Удаление репозитория Flathub

sudo flatpak remote-delete --system flathub

9.3 Удаление пакетов Flatpak и плагинов

sudo apt remove --purge flatpak gnome-software-plugin-flatpak plasma-discover-backend-flatpak
sudo apt autoremove --purge

Что делает:

  • apt remove --purge — удаляет пакеты и их конфигурационные файлы
  • apt autoremove --purge — удаляет неиспользуемые зависимости

💡 Примечание: --purge удаляет не только пакеты, но и конфигурационные файлы. Если вы планируете ставить Flatpak снова и хотите сохранить свои настройки, вместо --purge используйте просто remove.

9.4 Удаление пользовательских данных

⚠️ Внимание: Следующая команда безвозвратно удаляет ВСЕ данные всех Flatpak-приложений: настройки, сохранения, кэш. Если нужно что-то сохранить — сделайте резервную копию директории ~/.var/app/.

rm -rf ~/.var/app/

9.5 Удаление системных данных Flatpak

⚠️ Внимание: Эта команда удаляет все системные Flatpak-приложения и рантаймы, если они ещё остались.

sudo rm -rf /var/lib/flatpak

9.6 Проверка удаления

dpkg-query -W -f='${db:Status-Abbrev} ${binary:Package}\n' flatpak 2>/dev/null | grep -E '^(ii|rc)' || echo "flatpak package not installed"

✅ Ожидаемый вывод:

flatpak package not installed

Если вы видите строку с flatpak — пакет всё ещё установлен.

10. 📝 Чек-лист: всё готово к работе

  • [ ] Система обновлена: sudo apt update и sudo apt upgrade (подтвердите установку вручную)
  • [ ] Flatpak установлен: flatpak --version показывает версию
  • [ ] Репозиторий Flathub добавлен: flatpak remotes --system показывает flathub
  • [ ] Можете найти приложение: flatpak search gimp возвращает результаты
  • [ ] Можете установить приложение: sudo flatpak install flathub org.gimp.GIMP
  • [ ] Можете установить приложение из .flatpakref (если есть такой файл)
  • [ ] Приложение запускается: flatpak run org.gimp.GIMP
  • [ ] Обновления работают: sudo flatpak update --system
  • [ ] Установлен плагин для GNOME Software или KDE Discover

Заключение

Вы успешно установили Flatpak на Debian и добавили репозиторий Flathub. Теперь вам доступны тысячи современных приложений в изолированном окружении, которые не конфликтуют с системными пакетами.

Что дальше:

  • Установите Flatseal для графического управления разрешениями Flatpak-приложений
  • Изучите официальную документацию Flatpak
  • Настройте автоматическое обновление Flatpak-пакетов через cron или systemd-timer (если нужно)

Связанные статьи:

Связанные записи