TortoiseSVN Relocate: Change Repository URL

Last updated: 30 October 2026

If your Subversion repository moved to a new address, you do not need to check out a fresh working copy and copy your changes across. TortoiseSVN's Relocate command rewrites the repository URL stored in your working copy. Use it only when the repository itself kept the same content and only its address changed.

Quick answer
  • Use Relocate when: the server IP, protocol (http to https) or root path changed.
  • Do not use it to switch branches (use Switch) or to move to a different repository (make a fresh checkout).
  • Command line: svn relocate NEW_URL in the working copy root.

In this guide

When to use Relocate

  • The server's IP address or host name changed.
  • The protocol changed, for example from http to https.
  • The repository root path changed in the server setup.

Your working copy still points to the same repository, only at a new address.

Relocate with TortoiseSVN

  1. Commit or back up any local changes first, as a precaution.
  2. Right-click the root folder of the working copy. The Relocate entry only appears on the root.
  3. Choose TortoiseSVN, then Relocate.
  4. Enter the new repository URL and confirm. TortoiseSVN checks that the new URL points to the same repository, then updates the stored URL for every file and folder.

Relocate from the command line

svn info | grep URL
svn relocate https://new-server/svn/project

On older Subversion clients the command is svn switch --relocate OLD_URL NEW_URL.

What not to do

The TortoiseSVN manual warns that Relocate is not for switching to another branch or directory within the same repository (use Switch), and not for moving to a different repository (use a clean checkout). Using it that way corrupts the working copy and causes repeated errors on update and commit. Only a fresh checkout fixes that.

FAQ

Will I lose my local changes?

No. Relocate only rewrites URLs; your modified files stay as they are.

Why is Relocate missing from the menu?

You right-clicked a subfolder. Use the working copy root.

Can I relocate if the repository UUID differs?

No. A different UUID means a different repository, so check out again.

Sources

More on this site: Security guides · All IT guides

Comments