Where Does Rye Store Toolchains and Config?
Rye's .rye home with toolchains, shims and config.toml plus the RYE_HOME override.
Last updated
Rye centralizes Python management in a .rye home folder in your profile. Toolchains, shims, global tools and config.toml all branch below it, while each project keeps its own .venv and lockfiles.
RYE_HOME relocates everything for isolated setups. Add the shims dir to PATH or python resolves to system builds despite a healthy Rye install.
Where Rye stores this, by platform
%USERPROFILE%\.rye\config.toml
Home at %USERPROFILE%\.rye with py toolchains, shims and tools below it. Shims path %USERPROFILE%\.rye\shims belongs on PATH. Override root with RYE_HOME.
~/.rye/config.toml
Same layout. Source $HOME/.rye/env from profile so shims win on PATH. Global tools install under ~/.rye/tools with shims alongside.
~/.rye/config.toml
Same layout. Edit defaults with rye config --set in dotted notation rather than hand editing where possible.
Frequently asked questions
How do I fully remove Rye?
Run rye self uninstall, unsource $HOME/.rye/env from shell profiles, then delete ~/.rye. That clears toolchains, shims and global tools together.
Where are Rye project environments?
In .venv beside each pyproject.toml, not in .rye home. The home folder only carries shared toolchains, shims and global config.
Notice an outdated path? Let us know.