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

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

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

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

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

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

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

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

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

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

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

sudo whoami

✅ Если выводит root — всё в порядке, можете продолжать.

❌ Если выводит is not in the sudoers file — сначала пройдите наше руководство по настройке sudo

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

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

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

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

sudo apt update && sudo apt upgrade -y

Что делает:

• sudo — права суперпользователя
• apt update — обновляет список доступных пакетов
• && — выполняет следующую команду только если предыдущая успешна
• apt upgrade -y — обновляет все установленные пакеты, -y автоматически подтверждает

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

2.2 Установка Flatpak

sudo apt install flatpak -y

Что делает:

• apt install flatpak -y — устанавливает пакет Flatpak из официальных репозиториев Debian

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

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

flatpak --version

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

Для Debian 13 (Trixie):

Flatpak 1.16.2

Для Debian 12 (Bookworm):

Flatpak 1.14.4

Для Debian 11 (Bullseye):

Flatpak 1.10.8

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

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

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

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 бесполезен.

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

flatpak remotes --system --columns=name

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

flathub

Если вы видите 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 -y

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

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

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

5.2 Для KDE Discover

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

sudo apt install plasma-discover-backend-flatpak -y

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

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

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

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

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

Что делает:

• flatpak install — устанавливает приложение
• --system — системная установка (для всех пользователей)
• flathub — из какого репозитория
• org.gimp.GIMP — идентификатор приложения

Зачем: Системная установка удобна на рабочих станциях с несколькими пользователями.

Альтернатива (только для текущего пользователя):

flatpak install --user flathub org.gimp.GIMP

(Без sudo, с флагом --user)

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

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.5 Запуск приложений из терминала

flatpak run org.gimp.GIMP

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

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

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

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

sudo flatpak update --system

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

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

sudo flatpak update --system org.gimp.GIMP

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

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 устарели или отсутствуют.

Решение: Обновите метаданные Flathub:

sudo flatpak update --system --appstream
flatpak remotes --system --columns=name

Убедитесь, что в выводе есть flathub, затем повторите поиск:

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 для вашего окружения рабочего стола.

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

sudo apt install xdg-desktop-portal-gtk -y

Решение для KDE Plasma:

sudo apt install xdg-desktop-portal-kde -y

После установки выйдите из системы и зайдите снова. Проверьте статус портала:

systemctl --user status xdg-desktop-portal

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

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

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

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

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

Для установки только текущего пользователя (без sudo):
flatpak override --user --filesystem=home org.gimp.GIMP

Для системной установки (для всех пользователей):
sudo flatpak override --system --filesystem=home org.gimp.GIMP

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

Проверка применённых разрешений:

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

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

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

sudo flatpak install flathub com.github.tchx84.Flatseal

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

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

Решение: Обновите все Flatpak-рантаймы:

sudo flatpak update --system

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

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 -y
sudo apt autoremove --purge -y

Что делает:

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

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

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

rm -rf ~/.var/app/

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

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

sudo rm -rf /var/lib/flatpak

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

dpkg -l flatpak

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

dpkg-query: no packages found matching flatpak

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

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

• [ ] Flatpak установлен: flatpak --version показывает версию
• [ ] Репозиторий Flathub добавлен: flatpak remotes --system показывает flathub
• [ ] Можете найти приложение: flatpak search gimp возвращает результаты
• [ ] Можете установить приложение: sudo flatpak install flathub org.gimp.GIMP
• [ ] Приложение запускается: flatpak run org.gimp.GIMP
• [ ] Обновления работают: sudo flatpak update --system

Заключение

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

Что дальше:

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