From 42fbb94e7bc8c33249906551cf1a1b73417e6352 Mon Sep 17 00:00:00 2001
From: Denperidge <denperidge@gmail.com>
Date: Mon, 20 Jan 2025 19:30:38 +0100
Subject: [PATCH] [docs] Customization - changing logo

---
 docs/admin/customization.rst | 69 ++++++++++++++++++++++++++++++++++++
 docs/admin/index.rst         |  1 +
 2 files changed, 70 insertions(+)
 create mode 100644 docs/admin/customization.rst

diff --git a/docs/admin/customization.rst b/docs/admin/customization.rst
new file mode 100644
index 000000000..c5b13c69a
--- /dev/null
+++ b/docs/admin/customization.rst
@@ -0,0 +1,69 @@
+.. _customization:
+
+===================
+Customization
+===================
+
+.. sidebar:: further read
+
+   - :ref:`brand settings  <settings brand>`
+
+.. contents::
+   :depth: 2
+   :local:
+   :backlinks: entry
+
+.. _searxng logo:
+
+Changing the logo
+=============
+
+You can change the logo of the simple theme depending on the :ref:`installation` method. 
+
+Docker
+------------------------
+When running inside of :ref:`installation docker`, you can use the Docker CLI or Docker-Compose
+
+Docker CLI:
+
+.. code:: sh
+
+    docker run -v /path/to/image.png:/usr/local/searxng/searx/static/themes/simple/img/searxng.png -p 8888:8080 searxng/searxng
+
+
+Docker-Compose (based on `mrpaulblack's solution <https://github.com/searxng/searxng-docker/discussions/57#discussioncomment-2597013>`):
+
+.. code:: yaml
+    
+    services:
+      searxng:
+        image: searxng/searxng:latest
+        volumes:
+          - /path/to/image.png:/usr/local/searxng/searx/static/themes/simple/img/searxng.png
+
+NGINX
+------------------------
+If you're using :ref:`installation nginx`, you can use the following solution from **roughnecks** in the searxng community chat.
+
+.. code:: nginx
+
+    location /searxng/static/themes/simple/img/searxng.png {
+        root /var/www/html/;
+        try_files /images/mylogo.png =404;
+    }
+
+Caddy
+------------------------
+If you're using Caddy, you can use the following solution
+
+.. code:: caddy
+
+    searxng.example.com {
+        handle_path /static/themes/simple/img/searxng.png {
+              root /srv/searxng/
+              try_files {path} /banner.png =404
+              file_server
+        }
+
+        reverse_proxy 127.0.0.1:8888
+    }
diff --git a/docs/admin/index.rst b/docs/admin/index.rst
index b47074a8f..b55874cd5 100644
--- a/docs/admin/index.rst
+++ b/docs/admin/index.rst
@@ -20,4 +20,5 @@ Administrator documentation
    api
    architecture
    plugins
+   customization
    buildhosts