From 4dcee1aca0cc3f777ee39df7349946bec53b2ff5 Mon Sep 17 00:00:00 2001
From: Komh <mail@guojing.io>
Date: Sun, 12 Jul 2026 21:34:52 +0800
Subject: [PATCH] docs: add Flatpak (FlatPark) install method for Linux

Adds the Flatpak installation commands to the README (en/zh-CN) and the
website getting-started page (en/cn), as discussed in #3225.

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
---
 README.md                                |  9 +++++++++
 README.zh-CN.md                          |  9 +++++++++
 docs/content/docs/getting-started.cn.mdx | 15 ++++++++++++++-
 docs/content/docs/getting-started.mdx    | 15 ++++++++++++++-
 4 files changed, 46 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 36fe8b0ac..ff1d54307 100644
--- a/README.md
+++ b/README.md
@@ -213,6 +213,15 @@ scoop install dbx
 winget install t8y2.dbx
 ```
 
+**Flatpak (Linux):**
+
+```bash
+flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
+flatpak install flatpark com.dbxio.dbx
+```
+
+Updates then arrive through the regular `flatpak update`. See the [DBX page on FlatPark](https://flatpark.org/apps/com.dbxio.dbx/) for details.
+
 ## Self-Hosted (Docker)
 
 DBX provides a web version that can be deployed via Docker. The examples use
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 5cae3f248..c3ef866e1 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -213,6 +213,15 @@ scoop install dbx
 winget install t8y2.dbx
 ```
 
+**Flatpak (Linux)：**
+
+```bash
+flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
+flatpak install flatpark com.dbxio.dbx
+```
+
+之后通过常规的 `flatpak update` 即可获取更新。详见 [FlatPark 上的 DBX 页面](https://flatpark.org/apps/com.dbxio.dbx/)。
+
 ## 自托管 (Docker)
 
 DBX 提供 Web 版本，可通过 Docker 部署。示例使用 `latest` 标签以拉取当前发布版本。
diff --git a/docs/content/docs/getting-started.cn.mdx b/docs/content/docs/getting-started.cn.mdx
index f2d2eca3e..2940003f6 100644
--- a/docs/content/docs/getting-started.cn.mdx
+++ b/docs/content/docs/getting-started.cn.mdx
@@ -46,7 +46,20 @@ description: 安装 DBX、创建第一个连接，并了解桌面版、Docker 
 
   </Tab>
   <Tab value="Linux">
-    从 [GitHub Releases](https://github.com/t8y2/dbx/releases) 下载对应安装包：
+    使用 Flatpak 从 [FlatPark](https://flatpark.org/apps/com.dbxio.dbx/) 安装（适用于任意发行版）：
+
+    ```bash
+    flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
+    flatpak install flatpark com.dbxio.dbx
+    ```
+
+    之后可用以下命令更新：
+
+    ```bash
+    flatpak update com.dbxio.dbx
+    ```
+
+    也可以从 [GitHub Releases](https://github.com/t8y2/dbx/releases) 下载对应安装包：
 
     | 格式 | 适用场景 |
     |---|---|
diff --git a/docs/content/docs/getting-started.mdx b/docs/content/docs/getting-started.mdx
index 3df4cfb35..c70d58d2b 100644
--- a/docs/content/docs/getting-started.mdx
+++ b/docs/content/docs/getting-started.mdx
@@ -46,7 +46,20 @@ This guide gets you through three things:
 
   </Tab>
   <Tab value="Linux">
-    Download a package from [GitHub Releases](https://github.com/t8y2/dbx/releases):
+    Install with Flatpak from [FlatPark](https://flatpark.org/apps/com.dbxio.dbx/) (works on any distribution):
+
+    ```bash
+    flatpak remote-add --if-not-exists flatpark https://dl.flatpark.org/flatpark.flatpakrepo
+    flatpak install flatpark com.dbxio.dbx
+    ```
+
+    Update later with:
+
+    ```bash
+    flatpak update com.dbxio.dbx
+    ```
+
+    You can also download a package from [GitHub Releases](https://github.com/t8y2/dbx/releases):
 
     | Format | Use Case |
     |---|---|