.\" Man page generated from reStructuredText
.\" by the Docutils 0.22 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PIP-CONFIG" "1" "Jul 31, 2025" "25.2" "pip"
.SH NAME
pip-config \- description of pip config command
.SH DESCRIPTION
.sp
Manage local and global configuration.
.sp
Subcommands:
.INDENT 0.0
.IP \(bu 2
list: List the active configuration (or from the file specified)
.IP \(bu 2
edit: Edit the configuration file in an editor
.IP \(bu 2
get: Get the value associated with command.option
.IP \(bu 2
set: Set the command.option=value
.IP \(bu 2
unset: Unset the value associated with command.option
.IP \(bu 2
debug: List the configuration files and values defined under them
.UNINDENT
.sp
Configuration keys should be dot separated command and option name,
with the special prefix \(dqglobal\(dq affecting any command. For example,
\(dqpip config set global.index\-url \%<https://\:example\:.org/>\(dq would configure
the index url for all commands, but \(dqpip config set download.timeout 10\(dq
would configure a 10 second timeout only for \(dqpip download\(dq commands.
.sp
If none of \-\-user, \-\-global and \-\-site are passed, a virtual
environment configuration file is used if one is active and the file
exists. Otherwise, all modifications happen to the user file by
default.

.SH USAGE
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python \-m pip config [<file\-option>] list
python \-m pip config [<file\-option>] [\-\-editor <editor\-path>] edit

python \-m pip config [<file\-option>] get command.option
python \-m pip config [<file\-option>] set command.option value
python \-m pip config [<file\-option>] unset command.option
python \-m pip config [<file\-option>] debug
.EE
.UNINDENT
.UNINDENT
.SH OPTIONS
.sp
.INDENT 0.0
.TP
.B \-\-editor <editor>
Editor to use to edit the file. Uses VISUAL or EDITOR environment variables if not provided.
.sp
(environment variable: \fBPIP_EDITOR\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-global
Use the system\-wide configuration file only
.sp
(environment variable: \fBPIP_GLOBAL\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-user
Use the user configuration file only
.sp
(environment variable: \fBPIP_USER\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-site
Use the current environment configuration file only
.sp
(environment variable: \fBPIP_SITE\fP)
.UNINDENT

.SH Author
pip developers
.SH Copyright
The pip developers
.\" End of generated man page.