install scrpts and fiix ux

2026-05-31 06:42:00 +02:00
parent 3256ae34fe
commit 6f2c266e7c
11 changed files with 849 additions and 48 deletions
@@ -196,3 +196,65 @@ PYTORRENT_DEBUG_INSTALL=1
 ```

 On RHEL-compatible systems the installer also tries to enable CRB/PowerTools and installs `libcurl-devel`, `redhat-rpm-config`, `patch`, `diffutils`, `findutils`, `file`, and `libstdc++-devel`, because minimal Alma/Rocky images often do not include enough build tooling.
+
+## pyTorrent-only installer
+
+Use this installer when rTorrent is already configured and pyTorrent only needs a web UI service and one rTorrent profile.
+
+Interactive local run:
+
+```bash
+sudo bash scripts/install_pytorrent_only.sh
+```
+
+Bootstrap run from repository:
+
+```bash
+curl -fsSL https://git.linuxiarz.pl/gru/pyTorrent/raw/branch/master/scripts/install_pytorrent.sh | sudo bash
+```
+
+Non-interactive example for an existing TCP SCGI backend:
+
+```bash
+sudo bash scripts/install_pytorrent_only.sh \
+  --yes \
+  --user pytorrent \
+  --port 8090 \
+  --scgi-url scgi://127.0.0.1:5000 \
+  --auth enable \
+  --auth-provider local \
+  --auth-user pytorrent \
+  --auth-password 'change-this-password' \
+  --logs enable \
+  --libs offline
+```
+
+Reverse proxy example:
+
+```bash
+sudo bash scripts/install_pytorrent_only.sh \
+  --yes \
+  --port 8090 \
+  --reverse-proxy yes \
+  --proxy-domains torrent.example.com,pythong.example.com \
+  --local-origins http://10.10.10.22:8890
+```
+
+Unix socket rTorrent backend via rtorrent-scgi-proxy:
+
+```bash
+sudo bash scripts/install_pytorrent_only.sh \
+  --yes \
+  --rtorrent-socket /run/rtorrent/rtorrent.sock \
+  --install-scgi-proxy yes \
+  --proxy-listen 127.0.0.1:5050 \
+  --proxy-allow-net 127.0.0.1 \
+  --scgi-url scgi://127.0.0.1:5050/proxy/change-me-long-random-token
+```
+
+Notes:
+
+- The default application port is `8090`; high ports are recommended because ports below `1024` usually require extra privileges or may be blocked by the system.
+- Offline frontend libraries are the default. Use `--libs online` only when CDN loading is preferred.
+- Local auth is configured directly by the installer. External auth providers require a trusted reverse proxy setup; see `auth.md`.
+- Reverse proxy mode enables `PYTORRENT_PROXY_FIX_ENABLE`, secure cookies and CORS/API origins for the HTTPS domains plus localhost/local IP origins.