---
name: "pyenv-install"
section: "1"
platform: "linux"
package: "pyenv"
version: "2.5.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/pyenv-install"
---

# pyenv-install(1)

Install a Python version using python-build

## NAME

**pyenv-install** - Install a Python version using python-build

## SYNOPSIS

**pyenv install** \[**options**\] \<**version**\>...

**pyenv install** \[**options**\] \<**definition-file**\>

**pyenv install** **-l** \| **--list**

**pyenv install** **--version**

## DESCRIPTION

The **pyenv install** command allows you to install Python versions using **python-build**, a tool for compiling and installing Python versions from source.

## OPTIONS

- **-l**, **--list**

  List all available versions that can be installed.

- **-f**, **--force**

  Install the version even if it is already installed.

- **-s**, **--skip-existing**

  Skip the installation if the version is already installed.

- **-k**, **--keep**

  Keep the source tree in the build root directory after installation.

- **-p**, **--patch**

  Apply a patch from standard input before building.

- **-v**, **--verbose**

  Enable verbose mode, printing detailed information during installation.

- **--version**

  Show the version of the python-build tool.

- **-g**, **--debug**

  Enable debug mode for detailed logging of the installation process.

## EXAMPLES

To install a specific version of Python, such as Python 3.9.6:

```
$ pyenv install 3.9.6
```

To list all available Python versions:

```
$ pyenv install --list
```

To force the installation of a version even if it is already installed:

```
$ pyenv install -f 3.8.10
```

To install Python 3.7.9 and keep the source tree after installation:

```
$ pyenv install -k 3.7.9
```

## SEE ALSO

[*pyenv*(1)](/pyenv/1.md), [*python-build*(1)](/python-build/1.md)

## AUTHORS

Written by Yamashita, Yuu \<peek824545201@gmail.com\>, Sam Stephenson \<sam@sls.name\>.

This manual page was written by Josenison F. da Silva \<nilsonfsilva@hotmail.com\> for the Debian project (but may be used by others).