For Developers‎ > ‎How-Tos‎ > ‎

Install depot_tools

Chromium and Chromium OS use a package of scripts called depot_tools to manage checkouts and code reviews.  
The depot_tools package includes gclient, gclgit-clrepo, and others.

Installing on Linux and Mac

  1. Confirm git is installed. git 2.2.1+ recommended.

  2. Fetch depot_tools: 
    $ git clone

  3. Add depot_tools to your PATH:
    $ export PATH=`pwd`/depot_tools:"$PATH"

    • Yes, you want to put depot_tools ahead of everything else, otherwise gcl will refer to the GNU Common Lisp compiler.
    • You may want to add this to your .bashrc file or your shell's equivalent so that you don’t need to reset your $PATH manually each time you open a new shell.

Installing on Windows (Cygwin and non-Cygwin)


Chromium is mostly designed to be run using the native Windows tools and the Msys (Git for Windows) toolchain. You can also use Cygwin, but that is supported in a more ad-hoc manner. The cygwin tools do not interoperate with the native tools very well, so first decide if you want to use cygwin or not. Then, do not switch. If you use native svn on a cygwin's svn checkout and it blows up, you are on your own, e.g. you'll need to do a fresh checkout.


If using Cygwin, you should have already installed cygwin by this point.
  1. Get a copy of depot_tools:
    • Cygwin: Check out the tools using the command in step (2) for Linux and Mac above.
      New versions of cygwin do not include root certs by default so you need to install a "ca-certificates-1.*-*" package!
    • Non-cygwin: Download and decompress it.
      • Do not use drag-n-drop or copy-n-paste extract from Explorer, this will not extract the hidden ".git" folder which is necessary for depot_tools to autoupdate itself. You can use "Extract all..." from the context menu though.
      • Do not extract to a path containing spaces. If you do, gclient will produce the error "update_depot_tools.bat was not expected at this time" or similar.
  2. Add depot_tools to the end (not start!) of your PATH:
    • With Administrator access:
      • Control Panel > System and Security > System > Advanced system settings
      • Modify the PATH system variable to include depot_tools
    • Without Administrator access:
      • Control Panel > User Accounts > User Accounts > Change my environment variables
      • Add a PATH user variable: %PATH%;C:\path\to\depot_tools
  3. Non-cygwin: Run gclient from the cmd shell. The first time it is run, it will install its own copy of svn and other tools. If you run gclient from a non-cmd shell, it may appear to run properly, but svn, python, and other tools may not get installed correctly (while it should work fine from a msys bash shell, you may still trip over bugs from time to time).
  4. Cygwin only: Close your shells, reopen a Cygwin shell, and ensure that which svn reports /usr/bin/svn If not, you either didn't install the svn package properly when installing Cygwin, or you put depot_tools on the front of your PATH instead of the back.  Fix this before checking out any code, as once you check out, you want to always use the same svn (Cygwin or depot_tools) to work with that checkout -- otherwise strange things can happen that are most easily fixed by completely wiping the checkout.

See also Howto: depot tools