From 86d7793b95439b15dfd355198d19866df823073b Mon Sep 17 00:00:00 2001
From: Admin9705 <9705@duck.com>
Date: Sun, 8 Jun 2025 17:01:53 -0400
Subject: [PATCH] Update installation instructions to recommend creating and
 activating a virtual environment for Ubuntu 24.04+, and change the
 application run command from `python run.py` to `python3 main.py`. Add a note
 for Ubuntu users to prevent installation issues.

---
 docs/getting-started/installation.html | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/getting-started/installation.html b/docs/getting-started/installation.html
index cc13f586..00c711d6 100644
--- a/docs/getting-started/installation.html
+++ b/docs/getting-started/installation.html
@@ -246,13 +246,21 @@
                         <li>Navigate to the directory:
                             <pre class="terminal"><code class="command-prompt">cd Huntarr.io</code></pre>
                         </li>
+                        <li><strong>Create and activate a virtual environment (recommended for Ubuntu 24.04+):</strong>
+                            <pre class="terminal"><code class="command-prompt">python3 -m venv huntarr-env
+source huntarr-env/bin/activate  # On Windows: huntarr-env\Scripts\activate</code></pre>
+                        </li>
                         <li>Install Python dependencies:
                             <pre class="terminal"><code class="command-prompt">pip install -r requirements.txt</code></pre>
                         </li>
                         <li>Run the application:
-                            <pre class="terminal"><code class="command-prompt">python run.py</code></pre>
+                            <pre class="terminal"><code class="command-prompt">python3 main.py</code></pre>
                         </li>
                     </ol>
+                    
+                    <div class="alert alert-info">
+                        <strong>Note for Ubuntu 24.04+ users:</strong> Modern Ubuntu versions require the use of virtual environments to prevent conflicts with system packages. The virtual environment step is highly recommended to avoid installation issues.
+                    </div>
                 </div>
             </section>