diff --git a/admin-guide/configuration/software/packages.md b/admin-guide/configuration/software/packages.md
index 23e1de5c..ee116d26 100644
--- a/admin-guide/configuration/software/packages.md
+++ b/admin-guide/configuration/software/packages.md
@@ -87,6 +87,35 @@ To install a packages for specific python versions use the tag `:pip<version>` (
 
 Note that packages installed with `pip` are not updated automatically!
 
+
+## Install Software using Flatpak
+
+The `flatpak` tag can be used to install a software via flatpak. Best use the full Flatpak Application ID, like `pygame-utility`:
+
+```yaml
+base::pkg_group::my_flatpak_software:
+    - 'dev.zed.Zed:flatpak'
+```
+
+On [Flathub](flathub) you find the Application ID if you press the down arrow next to the `Install` button:
+
+![Flathub install commands](packages/zed_on_flathub.png)
+
+Note that flatpak software is by default updated automatically, see [guide "Automated Package Updates"](package_updates) for details.
+
+The Flathub package "remote" is already installed, to add other "remotes" check out the [Configure Flatpak Remotes](flatpak_remotes) guide.
+
+## Remove Packages
+
+To remove an already installed package, append the `:absent` tag to the package name in the package group:
+
+```
+base::pkg_group::java:
+    - 'java-1.8.0-openjdk:absent'
+    - 'java-11-openjdk'
+    - 'java-17-openjdk'
+```
+
 ## Remove Packages
 
 To remove an already installed package, append the `:absent` tag to the package name in the package group:
diff --git a/admin-guide/configuration/software/packages/zed_on_flathub.png b/admin-guide/configuration/software/packages/zed_on_flathub.png
new file mode 100644
index 00000000..8d2e3308
Binary files /dev/null and b/admin-guide/configuration/software/packages/zed_on_flathub.png differ