Frequently Asked Questions
Should I install Turborepo globally?
You have two options when working with Turborepo:
- Install it globally, via
npm install --global turbo
- Install a local version in your project
We recommend installing the
turbo CLI globally. This gives you a smooth, ergonomic experience for running tasks.
Do I have to use Remote Caching to use Turborepo?
No. Remote Caching is optional. However, you'll find it very useful to speed up development on a team, speed up builds inside of Docker, and also save space on your own machine.
Does Turborepo / Remote Caching store my source code?
No. Turborepo does not store source code. Without Remote Caching, no code ever leaves your machine—it will only cache artifacts to local disk.
With Turborepo's Remote Caching, you are responsible for configuring cache behavior and should only set up Turborepo to cache compiled artifacts. Please be aware that Turborepo treats all logs as artifacts and so these will be stored along with other cache artifacts.
Do I have to use Vercel to use Turborepo?
No. Turborepo is an open-source project and is not tied to any specific hosting provider or Remote Cache provider. The default Remote Cache provider is Vercel, should you opt-in to enable it. However, you can use any other provider you like if they support the same API. Several open-source community Remote Caches are compatible with Turborepo.
Can I use Turborepo with a different Remote Cache provider other than Vercel?
Yes. As long as the Remote Cache provider you choose supports the same API, you can use Turborepo with it.
Does Turborepo collect any personally identifiable information?
Due to the nature of Turborepo's functionality, no personal information is gathered when the open source binary is run locally. All cached artifacts are stored on your machine by default. Further, no log in information or contact details are collected by the
Does Turborepo collect any personally identifiable information when using Remote Caching?
How can I retain Fast Refresh in my Turborepo when using multiple Next.js applications?
Fast Refresh (opens in a new tab) gives you instantaneous feedback on edits made to your React components in Next.js applications.
If your Turborepo has multiple Next.js applications, you can use
next.config.js to ensure that imports across workspaces will work with Fast Refresh when changes are made. Turborepo will effectively watch for any edits and the rebuild when saving. You can get started from this example (opens in a new tab) which is set up to handle Fast Refresh.
next-transpile-modules(opens in a new tab) for the same Fast Refresh behavior.