Where Does Rye Store Python Toolchains?
Rye home directory on Linux with toolchains, shims and config.toml.
Last updated
Rye keeps downloaded Python toolchains, shims and its config.toml in a .rye directory in your home folder, with project virtualenvs inside each project. The shims directory must sit on PATH for version switching.
Projects pin interpreters in .python-version files. Copy the home folder to skip redownloading toolchains on a new machine.
Where Rye stores this, by platform
~/.rye
Holds toolchains per Python version, shims for the active one, and config.toml for mirrors and defaults. Project environments stay in .venv inside each repo. Copy the folder to migrate toolchains, or reinstall and let project files drive setup.
Frequently asked questions
How do I change Rye's Python version?
Run rye pin inside the project to write .python-version, then rye sync. Global default comes from config.toml in the folder above.
Where are Rye shims?
In the shims subfolder of ~/.rye above. That folder belongs on PATH for rye-managed tools to resolve.
Notice an outdated path? Let us know.