From 68121b182bc0beb208130f53c27f3577eb569882 Mon Sep 17 00:00:00 2001
From: shum <github.shum@liber.li>
Date: Fri, 28 Nov 2025 09:55:34 +0000
Subject: [PATCH] docs: add instructions for Ubuntu repository

---
 docs/APT.md       | 31 +++++++++++++++++++++++++++++++
 docs/DOWNLOADS.md |  1 +
 2 files changed, 32 insertions(+)
 create mode 100644 docs/APT.md

diff --git a/docs/APT.md b/docs/APT.md
new file mode 100644
index 0000000000..b0c7a7e4f5
--- /dev/null
+++ b/docs/APT.md
@@ -0,0 +1,31 @@
+---
+title: Installing SimpleX Chat Desktop from Ubuntu repository
+revision: 28.11.2025
+---
+
+# Installing SimpleX Chat Desktop from Ubuntu repository
+
+1. Install necessary dependencies:
+
+    ```sh
+    sudo apt update && sudo apt install -y curl gpg apt-transport-https
+    ```
+
+2. Setup SimpleX repository key:
+
+    ```sh
+    curl -sSL https://app.simplex.chat/deb-repo.gpg | gpg --dearmor | sudo tee /usr/share/keyrings/simplex-archive-keyring.gpg > /dev/null
+    ```
+
+3. Setup SimpleX repository:
+
+    ```sh
+    . /etc/os-release; printf "deb [signed-by=/usr/share/keyrings/simplex-archive-keyring.gpg] https://app.simplex.chat/deb ${VERSION_CODENAME} main" | sudo tee /etc/apt/sources.list.d/simplex.list
+    ```
+
+4. Install SimpleX Desktop:
+
+    ```sh
+    sudo apt update && sudo apt install simplex
+    ```
+
diff --git a/docs/DOWNLOADS.md b/docs/DOWNLOADS.md
index a23a920bbb..cd6a17d063 100644
--- a/docs/DOWNLOADS.md
+++ b/docs/DOWNLOADS.md
@@ -23,6 +23,7 @@ You can link your mobile device with desktop to use the same profile remotely, b
 - Most Linux distros: AppImage ([x86_64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-x86_64.AppImage), [aarch64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-aarch64.AppImage)) or [Flatpak](https://flathub.org/apps/chat.simplex.simplex).
 - Ubuntu 22.04 and Debian-based distros ([x86_64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-ubuntu-22_04-x86_64.deb), [aarch64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-ubuntu-22_04-aarch64.deb)).
 - Ubuntu 24.04 ([x86_64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-ubuntu-24_04-x86_64.deb), [aarch64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-ubuntu-24_04-aarch64.deb)).
+- From Ubuntu Repository [x86_64, aarch64](./APT.md)
 
 **Mac**: [x86_64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-macos-x86_64.dmg) (Intel), [aarch64](https://github.com/simplex-chat/simplex-chat/releases/latest/download/simplex-desktop-macos-aarch64.dmg) (Apple Silicon).