diff --git a/docs/source/depends.md b/docs/source/depends.md
new file mode 120000
index 000000000..974bd08b5
--- /dev/null
+++ b/docs/source/depends.md
@@ -0,0 +1 @@
+../../DEPENDS.md
\ No newline at end of file
diff --git a/docs/source/intro/01-install.md b/docs/source/intro/01-install.md
index 2474dcebb..243f7e395 100644
--- a/docs/source/intro/01-install.md
+++ b/docs/source/intro/01-install.md
@@ -1,59 +1,138 @@
# Installing Deluge
-These are the instructions for installing Deluge. Consider them a work-in-progress and
-feel free to make suggestions for improvement.
+Instructions for installing Deluge.
-## Ubuntu
+## Linux
-### PPA
+### Ubuntu
-Until the stable PPA is updated, the development version of Deluge can be used:
+One-click [**APT Install**](https://tinyurl.com/installdeluge)
- sudo add-apt-repository -u ppa:deluge-team/stable
- sudo apt install deluge
+```
+sudo apt install deluge
+```
-### PyPi
+[Package Details](https://packages.ubuntu.com/deluge)
-To install from Python PyPi, Deluge requires the following system installed packages:
+### Fedora
- sudo apt install python3-pip python3-libtorrent python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-appindicator3
+```
+sudo dnf install deluge
+```
+
+[Package Details](https://src.fedoraproject.org/rpms/deluge)
+
+### Arch
+
+```
+pacman -S deluge-gtk
+```
+
+[Arch Wiki](https://wiki.archlinux.org/title/Deluge)
+
+### OpenSUSE
+
+[**1 Click Install**](http://packman.links2linux.org/install/deluge)
+
+[Package Details](https://software.opensuse.org/package/deluge)
+
+### Gentoo
+
+[Package Details](https://packages.gentoo.org/packages/net-p2p/deluge)
+
+## Windows
+
+Unfortunately no official installer package currently available.
+
+See [Alternative Installs](#alternative-installs)
+
+## macOS
+
+Unfortunately no official installer package currently available.
+
+See [Alternative Installs](#alternative-installs)
+
+## FreeBSD
+
+```
+pkg add deluge
+```
+
+[Package details](https://www.freshports.org/net-p2p/deluge/)
+
+## PyPi
Install with pip:
pip install deluge
-Install with all optional dependencies:
+Install with all [optional dependencies][depends]:
pip install deluge[all]
-## Windows
+Will require system installed packages such as libtorent and GTK3. See [DEPENDS]
-Unfortunately due to move to GTK3 and Python 3 there is no installer package currently
-available for Windows.
+e.g. on Ubuntu/Debian install these packages:
-Intrepid users can install Deluge from separate packages as detailed in [issue #3201].
+ sudo apt install python3-pip python3-libtorrent python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-appindicator3
-## macOS
+## Alternative Installs
-There is no `.app` package currently for macOS, but can try Deluge with [Homebrew].
+### Ubuntu PPA
+
+The [stable PPA] contains the latest releases.
+
+ sudo add-apt-repository -u ppa:deluge-team/stable
+ sudo apt install deluge
+
+The [development PPA] contains daily builds from the `develop` branch.
+
+ sudo add-apt-repository -u ppa:deluge-team/develop
+ sudo apt install deluge
+
+### Windows Community
+
+Due to move to GTK3 and Python 3 and problems with pyinstaller there are only community
+created installers available.
+
+Check sticky topics in [Windows Forum] for latest updates.
+
+For reference [issue #3201] is tracking progress on an official installer.
+
+### macOS Community
+
+#### Unofficial `.app` packages
+
+Check sticky topics in [MacOS Forum]
+
+#### Macports
+
+```
+sudo port install deluge
+```
+
+[Package Details](https://ports.macports.org/port/deluge/)
+
+#### Homebrew
1. Install [Homebrew]
-2. Open a terminal.
-3. Run the following to install required packages:
+1. Open a terminal to install required packages:
brew install pygobject3 gtk+3 adwaita-icon-theme
brew install libtorrent-rasterbar
-4. To fix translations:
+1. To fix translations:
brew link gettext --force
-5. Install Deluge:
+1. Install Deluge:
- pip3 install deluge
+ pip install deluge
-[develop ppa]: https://launchpad.net/~deluge-team/+archive/ubuntu/develop/
+[development ppa]: https://launchpad.net/~deluge-team/+archive/ubuntu/develop/
+[stable ppa]: https://launchpad.net/~deluge-team/+archive/ubuntu/stable/
[homebrew]: https://brew.sh/
-[python 3.6]: https://www.python.org/downloads/release/python-368/
-[gvsbuild]: https://ci.appveyor.com/api/buildjobs/b0y2sttcq3t1071q/artifacts/gvsbuild-vs14-x64.tar.gz
-[issue #3201]: https://dev.deluge-torrent.org/ticket/3201#comment:9
+[issue #3201]: https://dev.deluge-torrent.org/ticket/3201
+[windows forum]: https://forum.deluge-torrent.org/viewforum.php?f=12
+[macos forum]: https://forum.deluge-torrent.org/viewforum.php?f=13
+[depends]: ../depends.md