pipx Configuration

pipx의 저장 위치, 실행 파일 노출 위치, 기본 Python interpreter와 package backend를 환경변수로 설정하는 방법을 정리한다.

Summary

pipx는 별도 사용자 configuration file을 사용하지 않으며 모든 설정은 선택적 환경변수로 제공한다. 현재 적용값과 platform별 기본값은 고정 경로를 추측하지 말고 pipx environment로 확인한다.

pipx environment
pipx environment --value PIPX_HOME
pipx environment --value PIPX_BIN_DIR

PIPX_HOME: 사용자별 virtual environment와 shared library data 위치를 지정한다.
PIPX_BIN_DIR: 사용자별 application link 위치를 지정한다.
PIPX_MAN_DIR: 사용자별 manual page link 위치를 지정한다.
PIPX_COMPLETION_DIR: shell completion 설치 위치를 지정한다.
PIPX_GLOBAL_HOME: –global 환경의 virtual environment 위치를 지정한다.
PIPX_GLOBAL_BIN_DIR: –global application link 위치를 지정한다.
PIPX_GLOBAL_MAN_DIR: –global manual page 위치를 지정한다.
PIPX_GLOBAL_COMPLETION_DIR: –global shell completion 위치를 지정한다.
PIPX_SHARED_LIBS: shared library directory를 지정한다.
PIPX_DEFAULT_PYTHON: 새 환경에 사용할 기본 Python interpreter를 지정한다.
PIPX_DEFAULT_BACKEND: 새 환경의 package backend를 pip 또는 uv로 지정한다.
PIPX_FETCH_PYTHON: 적합한 Python interpreter가 없을 때 standalone Python을 가져오는 정책을 지정한다.
~~PIPX_FETCH_MISSING_PYTHON~~: PIPX_FETCH_PYTHON=missing의 deprecated alias이다.
PIPX_DISABLE_SHARED_LIBS_AUTO_UPGRADE: shared library 자동 갱신을 비활성화한다.
PIPX_USE_EMOJI: terminal 출력의 emoji 사용 여부를 제어한다.
PIPX_MAX_LOGS: 보관할 log file 수를 지정한다.

export PIPX_DEFAULT_PYTHON=python3.13
export PIPX_DEFAULT_BACKEND=uv
pipx install ruff

기존 virtual environment는 생성 당시 기록된 backend를 유지한다. 명시적으로 전환하려면 reinstall에서 backend를 지정한다.

pipx reinstall ruff --backend uv

export PIPX_HOME="$XDG_DATA_HOME/pipx"
export PIPX_BIN_DIR="$HOME/.local/bin"
pipx ensurepath

이미 설치된 환경이 있을 때 변수만 변경하면 기존 application이 자동으로 이동하지 않는다. 변경 전 pipx list로 목록을 기록하고 공식 Move installation 절차를 확인한다.

pipx는 내부 installer에 PIP_* 환경변수를 전달한다. credential은 wiki, shell history, tracked file에 저장하지 않는다.

export PIP_INDEX_URL='https://packages.example.invalid/simple'
pipx install PACKAGE

일회성 설정은 –pip-args로 전달할 수 있지만 token이나 password를 command line에 직접 쓰지 않는다.

pipx environment
pipx list
pipx health