Skip to content

Commit

Permalink
reworked default directories header under configurations header
Browse files Browse the repository at this point in the history
  • Loading branch information
mohan43u committed May 30, 2022
1 parent 36ba1e2 commit c4fddc7
Showing 1 changed file with 29 additions and 29 deletions.
58 changes: 29 additions & 29 deletions docs/configuration.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,35 +9,6 @@ menu:
weight: 40
---

# Default Directories

Poetry uses these following default directories

## Config Directory

- Linux: `$XDG_CONFIG_HOME/pypoetry` or `~/.config/pypoetry`
- Windows: `%APPDATA%\pypoetry`
- MacOS: `~/Library/Preferences/pypoetry`

You can override this Config directory by setting `POETRY_CONFIG_DIR` environment variable


## Data Directory

- Linux: `$XDG_DATA_HOME/pypoetry` or `~/.local/share/pypoetry`
- Windows: `%APPDATA%\pypoetry`
- MacOS: `~/Library/Application Support/pypoetry`

You can override this Data Directory by setting `POETRY_DATA_DIR` environment variable. If `POETRY_HOME` environment variable is available, then `POETRY_HOME` will be given higher priority.

## Cache Directory

- Linux: `$XDG_CACHE_HOME/pypoetry` or `~/.cache/pypoetry`
- Windows: `%APPDATA%\pypoetry\Cache`
- MacOS: `~/Library/Caches/pypoetry`

You can override this Cache directory by setting `POETRY_CACHE_DIR` environment variable

# Configuration

Poetry can be configured via the `config` command ([see more about its usage here]({{< relref "cli#config" >}} "config command documentation"))
Expand Down Expand Up @@ -144,6 +115,35 @@ This also works for secret settings, like credentials:
export POETRY_HTTP_BASIC_MY_REPOSITORY_PASSWORD=secret
```

## Default Directories

Poetry uses these following default directories

### Config Directory

- Linux: `$XDG_CONFIG_HOME/pypoetry` or `~/.config/pypoetry`
- Windows: `%APPDATA%\pypoetry`
- MacOS: `~/Library/Preferences/pypoetry`

You can override this Config directory by setting `POETRY_CONFIG_DIR` environment variable


### Data Directory

- Linux: `$XDG_DATA_HOME/pypoetry` or `~/.local/share/pypoetry`
- Windows: `%APPDATA%\pypoetry`
- MacOS: `~/Library/Application Support/pypoetry`

You can override this Data Directory by setting `POETRY_DATA_DIR` environment variable. If `POETRY_HOME` environment variable is available, then `POETRY_HOME` will be given higher priority.

### Cache Directory

- Linux: `$XDG_CACHE_HOME/pypoetry` or `~/.cache/pypoetry`
- Windows: `%APPDATA%\pypoetry\Cache`
- MacOS: `~/Library/Caches/pypoetry`

You can override this Cache directory by setting `POETRY_CACHE_DIR` environment variable

## Available settings

### `cache-dir`
Expand Down

0 comments on commit c4fddc7

Please sign in to comment.