π« Toolkit to help you get started with SDD or any other process!
docs: document installing specify-cli from a custom package index (#4032)
Manfred Riemd75123146822
diff --git a/docs/install/pypi.md b/docs/install/pypi.mdindex 1b89d78e4..6f36df0a5 100644--- a/docs/install/pypi.md+++ b/docs/install/pypi.md@@ -35,6 +35,27 @@ pipx install specify-cli==0.12.11pip install specify-cli==0.12.11```+## Install from a custom or private package index++Some environments (corporate networks, mirrors, proxies, or artifact feeds) require installing `specify-cli` from a package index other than the default public PyPI. Each Python tool exposes a way to point at a different index β configure it before running the install commands above. Substitute your own index URL for the placeholder shown here.++```bash+# uv β via environment variable (applies to the whole command)+UV_DEFAULT_INDEX=https://your-index.example.com/pypi/simple/ uv tool install specify-cli++# uv β via flag+uv tool install --default-index https://your-index.example.com/pypi/simple/ specify-cli++# pipx β pass a pip argument through+pipx install specify-cli --index-url https://your-index.example.com/pypi/simple/++# pip+pip install specify-cli --index-url https://your-index.example.com/pypi/simple/+```++> [!NOTE]+> The same index configuration applies to pinned installs, upgrades (`--force`/`--upgrade`), and one-time usage β set the environment variable or flag on those commands too. If your index requires authentication, follow your tool's documentation and prefer credential environment variables, keyring, or netrc; do not embed secrets in command-line URLs because they can leak through shell history, process listings, or logs. Avoid committing secrets. For fully offline installs, see the [air-gapped installation guide](air-gapped.md).+## Verify```bashdiff --git a/docs/installation.md b/docs/installation.mdindex 4fa279564..67b69505e 100644--- a/docs/installation.md+++ b/docs/installation.md@@ -50,7 +50,7 @@ pipx install specify-clipip install specify-cli```-To install a specific release, pin the version β for example `uv tool install specify-cli==0.12.11`. See the [PyPI installation guide](install/pypi.md) for details, including how to upgrade.+To install a specific release, pin the version β for example `uv tool install specify-cli==0.12.11`. See the [PyPI installation guide](install/pypi.md) for details, including how to upgrade and how to [install from a custom or private package index](install/pypi.md#install-from-a-custom-or-private-package-index).### One-time Usage