flatpak - アプリケーションとランタイムを構築、インストール、実行
概要
flatpak [オプション...] {コマンド}
説明
Flatpak は、アプリケーションとそのアプリケーションが使用するランタイムを管理するためのツールです。Flatpak モデルでは、 アプリケーションは、使用されるホストシステムから独立して構築および配布でき、 実行時にある程度の程度でホストシステムから分離（サンドボックス化）されます。
Flatpak は、システム全体モードまたはユーザーごとのモードで動作できます。システム全体のデータ（ランタイム、アプリケーション、構成）は、$prefix/var/lib/flatpak/ に配置され、ユーザーごとのデータは $HOME/.local/share/flatpak/ に配置されます。これらの場所の下には、repo/ サブディレクトリにローカルリポジトリがあり、インストールされたランタイムとアプリケーションは、それぞれ runtime/ および app/ サブディレクトリに配置されます。
システム全体のリモートは、/usr/share/flatpak/remotes.d/ および /etc/flatpak/remotes.d/ に flatpakrepo(5) ファイルをドロップすることで、静的に事前構成できます。同じ名前のファイルが両方に存在する場合、/etc のファイルが優先されます。
$prefix/var/lib/flatpak/ に配置されるシステム全体のインストールに加えて、これは常にデフォルトと見なされますが、/etc/flatpak/installations.d/ の構成ファイルを使用して、追加のシステム全体のインストールを定義できます。構成ファイルは、少なくともインストールの ID と、絶対パスを定義する必要があります。DisplayName、Priority、StorageType などの他のオプションのパラメータもサポートされています。
Flatpak は、データを配布およびデプロイするために OSTree を使用します。使用するリポジトリは OSTree リポジトリであり、ostree ユーティリティを使用して操作できます。インストールされたランタイムとアプリケーションは、OSTree チェックアウトです。
^ latpak ユーティリティには、flatpak の構築などの基本的なコマンド（build-init、build、build-finish）が含まれています。より高度な構築サポートについては、別の flatpak-builder(1) ツールを参照してください。
Flatpak は、サイドロードリポジトリからのインストールをサポートします。これらは、リポジトリの一部をコピーしたもので（flatpak create-usb によって生成）、オフライン時（およびオンライン時のパフォーマンス向上）にインストールソースとして使用されます。このようなリポジトリは、インストールのディレクトリ（つまり、通常は /var/lib/flatpak/sideload-repos または ~/.local/share/flatpak/sideload-repos）の sideload-repos サブディレクトリ内のサイドロードソースへのシンボリックリンクを作成することで構成されます。さらに、/run/flatpak/sideload-repos にシンボリックリンクを作成することもできます。これは、再起動時にクリアされるため、永続的でないソースに適した場所です。これらのシンボリックリンクは、flatpak create-usb に渡されるディレクトリ（デフォルトでは、.ostree/repo サブパスに書き込みます）または、直接 OSTree リポジトリを指すことができます。
オプション
以下のグローバルオプションがサポートされます。個々のコマンドには独自のオプションがあります。
-h, --help
ヘルプオプションを表示して終了します。
-v, --verbose
コマンド処理中にデバッグ情報を表示します。-vv を使用すると、さらに詳細な情報が表示されます。
--ostree-verbose
コマンド処理中に OSTree のデバッグ情報を表示します。
--version
バージョン情報を表示して終了します。
--default-arch
デフォルトのアーキテクチャを表示して終了します。
--supported-arches
サポートされているアーキテクチャを優先順に表示して終了します。
--gl-drivers
アクティブな GL ドライバのリストを表示して終了します。
--installations
システムインストールのパスを表示して終了します。
--print-system-only
^ latpak --print-updated-env コマンドを実行するときに、ユーザーのホームインストールを含めずに、システム全体の Flatpak インストールの環境のみを出力します。
--print-updated-env
Flatpak を使用するために必要な環境変数のセットを出力し、現在の環境変数のセットを修正します。これは systemd 環境ジェネレータで使用することを意図しており、手動で実行する必要はありません。
コマンド
インストールされたアプリケーションとランタイムを管理するためのコマンド：
flatpak-install(1)
リモートまたはバンドルからアプリケーションまたはランタイムをインストールします。
flatpak-update(1)
インストールされたアプリケーションまたはランタイムを更新します。
flatpak-uninstall(1)
インストールされたアプリケーションまたはランタイムをアンインストールします。
flatpak-mask(1)
更新と自動インストールをマスクします。
flatpak-pin(1)
ランタイムをピン留めして、自動削除を防ぎます。
flatpak-list(1)
インストールされたアプリケーションと/またはランタイムを一覧表示します。
flatpak-info(1)
インストールされたアプリケーションまたはランタイムに関する情報を表示します。
flatpak-history(1)
履歴を表示します。
flatpak-config(1)
Flatpak の設定を管理します。
flatpak-repair(1)
Flatpak のインストールを修復します。
flatpak-create-usb(1)
アプリケーションまたはランタイムをリムーバブルメディアにコピーします。
アプリケーションとランタイムを検索するためのコマンド：
flatpak-search(1)
アプリケーションとランタイムを検索します。
実行中のアプリケーションを管理するためのコマンド：
flatpak-run(1)
アプリケーションを実行します。
flatpak-kill(1)
実行中のアプリケーションを停止します。
flatpak-override(1)
アプリケーションの権限をオーバーライドします。
flatpak-make-current(1)
実行するデフォルトのバージョンを指定します。
flatpak-enter(1)
実行中のアプリケーションのネームスペースに入ります。
ファイルアクセスを管理するためのコマンド：
flatpak-document-export(1)
アプリケーションに特定のファイルへのアクセスを許可します。
flatpak-document-unexport(1)
特定のファイルへのアクセスを無効にします。
flatpak-document-info(1)
特定のファイルに関する情報を表示します。
flatpak-documents(1)
エクスポートされたファイルを一覧表示します。
動的な権限ストアを管理するためのコマンド：
flatpak-permission-remove(1)
権限ストアから項目を削除します。
flatpak-permissions(1)
権限を一覧表示します。
flatpak-permission-show(1)
アプリケーションの権限を表示します。
flatpak-permission-reset(1)
アプリケーションの権限をリセットします。
flatpak-permission-set(1)
アプリケーションの権限を設定します。
リモートリポジトリを管理するためのコマンド：
flatpak-remotes(1)
構成されているすべてのリモートリポジトリを一覧表示します。
flatpak-remote-add(1)
新しいリモートリポジトリを追加します。
flatpak-remote-modify(1)
設定されたリモートリポジトリのプロパティを変更します。
flatpak-remote-delete(1)
設定されたリモートリポジトリを削除します。
flatpak-remote-ls(1)
設定されたリモートリポジトリの内容を一覧表示します。
flatpak-remote-info(1)
設定されたリモートリポジトリの参照に関する情報を表示します。
アプリケーションのビルドコマンド：
flatpak-build-init(1)
ビルドディレクトリを初期化します。
flatpak-build(1)
ビルドディレクトリでビルドコマンドを実行します。
flatpak-build-finish(1)
ビルドディレクトリをエクスポート用に最終処理します。
flatpak-build-export(1)
ビルドディレクトリをリポジトリにエクスポートします。
flatpak-build-bundle(1)
ローカルリポジトリ内の参照からバンドルファイルを作成します。
flatpak-build-import-bundle(1)
ファイルバンドルをローカルリポジトリにインポートします。
flatpak-build-sign(1)
アプリケーションまたはランタイムをエクスポートした後に署名します。
flatpak-build-update-repo(1)
リポジトリ内の summary ファイルを更新します。
flatpak-build-commit-from(1)
既存の参照に基づいて新しいコミットを作成します。
flatpak-repo(1)
リポジトリに関する情報を出力します。
サンドボックス内で使用できるコマンド：
flatpak-spawn(1)
別のサンドボックスでコマンドを実行します。
ファイル形式
Flatpak コマンドで使用されるファイル形式：
flatpakref(5)
アプリケーションまたはランタイムのリモートへの参照
flatpakrepo(5)
リモートへの参照
flatpak-remote(5)
リモートの構成
flatpak-installation(5)
インストール場所の構成
flatpak-metadata(5)
アプリケーションまたはランタイムに関する情報
環境
標準の環境変数（XDG_DATA_DIRS や XDG_DATA_HOME など）に加えて、Flatpak は独自の環境変数も参照します。
FLATPAK_BINARY
エクスポートされた .desktop ファイルやスクリプトに書き込まれる flatpak 実行ファイルへのパス。デフォルトは /usr/bin/flatpak ですが、ビルド時に --bindir でオーバーライドできます。
FLATPAK_BWRAP
サンドボックスを作成するために使用される bwrap(1) 実行ファイルへのパス。Flatpak のビルド時の構成に応じて、デフォルトは PATH を検索するか、通常は /usr/libexec/flatpak-bwrap としてインストールされる同梱版を使用します。
FLATPAK_CONFIG_DIR
Flatpak のサイト全体の構成の場所。設定されていない場合、/etc/flatpak が使用されます（ただし、ビルド時に --sysconfdir でオーバーライドできます）。
FLATPAK_DATA_DIR
Flatpak の OS レベルのデフォルトおよび統合フックの場所。設定されていない場合、/usr/share/flatpak が使用されます（ただし、ビルド時に --datadir でオーバーライドできます）。
FLATPAK_DBUSPROXY
サンドボックスとホストシステム間の D-Bus トラフィックをフィルタリングするために使用される xdg-dbus-proxy(1) 実行ファイルへのパス。Flatpak のビルド時の構成に応じて、デフォルトは PATH を検索するか、通常は /usr/libexec/flatpak-dbus-proxy としてインストールされる同梱版を使用します。
FLATPAK_DOWNLOAD_TMPDIR
OCI レイヤーをダウンロードするときに使用されるディレクトリへのパス。また、将来的には他のダウンロードにも使用される可能性があります。標準の TMPDIR は使用されません。これは、Flatpak アプリケーションが大きすぎて tmpfs に収まらない場合があるためです。
FLATPAK_FANCY_OUTPUT
ターミナルへの出力時に、装飾的な書式設定を避けるために0に設定できます。この機能は、標準出力がターミナルでない場合、またはG_MESSAGES_DEBUGが設定されている場合に、自動的に無効になります。
FLATPAK_FORCE_TEXT_AUTH
システム全体のインストールを変更する際に認証が必要な場合に、シンプルな組み込みのpolkit(8)エージェントの使用を強制するために、1に設定できます。デフォルトでは、利用可能な場合はデスクトップ環境のpolkitエージェントが使用され、通常はグラフィカルなプロンプトが表示されます。
FLATPAK_GL_DRIVERS
OpenGL、Vulkan、および同様のAPIで使用するグラフィックスドライバ拡張子の、コロンで区切られたリスト。優先順位の高いものから順に並べます。デフォルトでは、グラフィックスドライバが自動的に選択されます。このリストの値は、アクティブなgl-driver条件を持つ拡張子の名前の最後のドットで区切られたコンポーネントに一致します。一般的な値は、default、mesa-git、またはnvidia-550-120です（バージョン番号をnvidiaカーネルモジュールのメジャーバージョンとマイナーバージョンに置き換えます）。
FLATPAK_RUN_DIR
Flatpakランタイムのグローバルファイルの場所。設定されていない場合、/run/flatpakが使用されます。
FLATPAK_SYSTEM_CACHE_DIR
システム全体のインストールへのpull中に、一時的な子リポジトリが作成される場所。設定されていない場合、/var/tmp/内のディレクトリが使用されます。これは、システムリポジトリと同じファイルシステム上にある可能性が高く（例：reflinkコピーの可能性が高くなる）、ユーザーのホームディレクトリに一時データを保存することを避けることができるため、役立ちます。
FLATPAK_SYSTEM_DIR
デフォルトのシステム全体のインストールの場所。設定されていない場合、/var/lib/flatpakが使用されます（ただし、ビルド時に--localstatedirまたは-Dsystem_install_dirによってオーバーライドされる場合があります）。
FLATPAK_TTY_PROGRESS
ターミナルへの読み取り可能な進捗状況の報告を有効にするために、1に設定できます。この機能は、一部のターミナルエミュレータでOSC 9;4シーケンスがポップアップ通知として解釈されるため、デフォルトでは有効になっていません。
FLATPAK_USER_DIR
ユーザーごとのインストールの場所。設定されていない場合、$XDG_DATA_HOME/flatpakが使用されます。
関連項目
ostree(1)、ostree.repo(5)、flatpak-remote(5)、flatpak-installation(5)、https://www.flatpak.org