Where Does Vercel CLI Store Config and Cache?
Vercel CLI keeps global auth and config in a per OS data directory and keeps project link data in a .vercel folder. Older versions used ~/.vercel for global files.
Last updated
Current Vercel CLI stores global config.json and auth.json under a com.vercel.cli directory inside the OS data directory. Project directories gain a local .vercel folder after linking.
Legacy installs used ~/.vercel for global state. The local .vercel folder holds project.json with org and project identifiers and should usually stay out of version control if it contains sensitive data.
Where Vercel CLI stores this, by platform
%APPDATA%\com.vercel.cli
Expands to C:\Users\<user>\AppData\Roaming\com.vercel.cli where <user> is the account name. Holds config.json and auth.json. Legacy global path was %USERPROFILE%\.vercel. Use the global config option to relocate the directory.
/Users/<user>/Library/Application Support/com.vercel.cli
<user> is the macOS account name. Holds config.json and auth.json. Legacy global path was /Users/<user>/.vercel. Auth data here grants account access so keep it private.
/home/<user>/.local/share/com.vercel.cli
<user> is the Linux login name. If XDG_DATA_HOME is set to <data_dir>, the base is <data_dir>/com.vercel.cli. Holds config.json and auth.json. Legacy global path was /home/<user>/.vercel.
<project>/.vercel/project.json
<project> is the linked project directory. Same relative folder on Windows and macOS. Holds orgId and projectId created by the link step. Remove the .vercel folder to unlink.
Frequently asked questions
What is in the project .vercel folder?
project.json with org and project identifiers plus generated vercel.json for the linked setup. It is created on link. Delete the folder to unlink the directory.
Where are tokens?
In auth.json inside the global com.vercel.cli directory. Do not upload that directory to insecure locations. Use the token flag or VERCEL_TOKEN environment variable for CI runs.
Notice an outdated path? Let us know.