GRM-85: docs: add Gitea PyPI registry instructions for pip install

README.md

@@ -92,11 +92,35 @@ source .venv/bin/activate
 
 ### Option 2: Via pip (for using GRM without the full repo)
 
+GRM is published to the Gitea PyPI registry at
+`https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple`.
+The registry is publicly readable — no authentication required to install.
+
+**Quick install (one-off):**
+
+```bash
+pip install gitea-runner-manager --index-url https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple
+```
+
+**Persistent configuration (recommended):**
+
+Add the registry to `~/.pip/pip.conf` so future `pip install` commands find
+GRM automatically:
+
+```ini
+[global]
+extra-index-url = https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple
+```
+
+Then install normally:
+
 ```bash
 pip install gitea-runner-manager
 ```
 
-This installs the `grm` CLI and its Python dependencies. Note that the Ansible playbooks and role are bundled with the package, so `grm install` will work out of the box. However, for development or access to Make targets, clone the repository.
+This installs the `grm` CLI and its Python dependencies. The Ansible playbooks
+and role are bundled with the package, so `grm install` works out of the box.
+For development or access to Make targets, clone the repository (Option 1).
 
 ### Post-install configuration
 

docs/user/installation.md

@@ -51,11 +51,34 @@ source .venv/bin/activate
 
 ### Method 2: Via pip
 
+GRM is published to the Gitea PyPI registry at
+`https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple`.
+The registry is publicly readable — no authentication required to install.
+
+**Quick install (one-off):**
+
+```bash
+pip install gitea-runner-manager --index-url https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple
+```
+
+**Persistent configuration (recommended):**
+
+Add the registry to `~/.pip/pip.conf`:
+
+```ini
+[global]
+extra-index-url = https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple
+```
+
+Then install normally:
+
 ```bash
 pip install gitea-runner-manager
 ```
 
-This installs the `grm` CLI and its Python dependencies. The Ansible playbooks and role are bundled with the package, so `grm install` will work out of the box. However, for development or access to Make targets, clone the repository.
+This installs the `grm` CLI and its Python dependencies. The Ansible playbooks
+and role are bundled with the package, so `grm install` works out of the box.
+For development or access to Make targets, clone the repository (Method 1).
 
 ### Post-install configuration