diff --git a/docs/faq.rst b/docs/faq.rst
index d96fbed8d..fb86d8a91 100644
--- a/docs/faq.rst
+++ b/docs/faq.rst
@@ -416,13 +416,20 @@ also set it with the following command:
 
 You can also change the icon manually by following the steps:
 
-#. Find :file:`kitty.app` in the Applications folder, select it and press :kbd:`⌘+I`
-#. Drag :file:`kitty.icns` onto the application icon in the kitty info pane
-#. Delete the icon cache and restart Dock:
+.. tab:: macOS
 
-.. code-block:: sh
+    #. Find :file:`kitty.app` in the Applications folder, select it and press :kbd:`⌘+I`
+    #. Drag :file:`kitty.icns` onto the application icon in the kitty info pane
+    #. Delete the icon cache and restart Dock::
 
-    rm /var/folders/*/*/*/com.apple.dock.iconcache; killall Dock
+        rm /var/folders/*/*/*/com.apple.dock.iconcache; killall Dock
+
+.. tab:: Linux
+
+   #. Copy :file:`kitty.desktop` from the installation location (usually
+      :file:`/usr/share/applications` to :file:`~/.local/share/applications`
+   #. Edit the copied desktop file changing the ``Icon`` line to have
+      the absolute path to your desired icon.
 
 
 How do I map key presses in kitty to different keys in the terminal program?