Skip to content

Commit 86d7793

Browse files
committed
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.
1 parent 30fda47 commit 86d7793

File tree

1 file changed

+9
-1
lines changed

1 file changed

+9
-1
lines changed

docs/getting-started/installation.html

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -246,13 +246,21 @@ <h4><i class="fab fa-python" style="margin-right: 8px; color: #3776ab;"></i>From
246246
<li>Navigate to the directory:
247247
<pre class="terminal"><code class="command-prompt">cd Huntarr.io</code></pre>
248248
</li>
249+
<li><strong>Create and activate a virtual environment (recommended for Ubuntu 24.04+):</strong>
250+
<pre class="terminal"><code class="command-prompt">python3 -m venv huntarr-env
251+
source huntarr-env/bin/activate # On Windows: huntarr-env\Scripts\activate</code></pre>
252+
</li>
249253
<li>Install Python dependencies:
250254
<pre class="terminal"><code class="command-prompt">pip install -r requirements.txt</code></pre>
251255
</li>
252256
<li>Run the application:
253-
<pre class="terminal"><code class="command-prompt">python run.py</code></pre>
257+
<pre class="terminal"><code class="command-prompt">python3 main.py</code></pre>
254258
</li>
255259
</ol>
260+
261+
<div class="alert alert-info">
262+
<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.
263+
</div>
256264
</div>
257265
</section>
258266

0 commit comments

Comments
 (0)