JFrog Artifactory

uv can install packages from JFrog Artifactory, either by using a username and password or a JWT token.

To use it, add the index to your project:

pyproject.toml

[[tool.uv.index]]
name = "private-registry"
url = "https://<organization>.jfrog.io/artifactory/api/pypi/<repository>/simple"

Authenticate with username and password

$ export UV_INDEX_PRIVATE_REGISTRY_USERNAME="<username>"
$ export UV_INDEX_PRIVATE_REGISTRY_PASSWORD="<password>"

Authenticate with JWT token

$ export UV_INDEX_PRIVATE_REGISTRY_USERNAME=""
$ export UV_INDEX_PRIVATE_REGISTRY_PASSWORD="$JFROG_JWT_TOKEN"

Note

Replace PRIVATE_REGISTRY in the environment variable names with the actual index name defined in your pyproject.toml.

Publishing packages

Add a publish-url to your index definition:

pyproject.toml

[[tool.uv.index]]
name = "private-registry"
url = "https://<organization>.jfrog.io/artifactory/api/pypi/<repository>/simple"
publish-url = "https://<organization>.jfrog.io/artifactory/api/pypi/<repository>"

Important

If you use --token "$JFROG_TOKEN" or UV_PUBLISH_TOKEN with JFrog, you will receive a 401 Unauthorized error as JFrog requires an empty username but uv passes __token__ for as the username when --token is used.

To authenticate, pass your token as the password and set the username to an empty string:

$ uv publish --index <index_name> -u "" -p "$JFROG_TOKEN"

Alternatively, you can set environment variables:

$ export UV_PUBLISH_USERNAME=""
$ export UV_PUBLISH_PASSWORD="$JFROG_TOKEN"
$ uv publish --index private-registry

Note

The publish environment variables (UV_PUBLISH_USERNAME and UV_PUBLISH_PASSWORD) do not include the index name.