svn checkout
Prev | svn Subcommands | Next

## Name

svn checkout — Check out a working copy from a repository.

## Synopsis

    svn checkout URL[@REV]... [PATH]

## Description

Check out a working copy from a repository. If `PATH` is omitted, the basename of the URL will be used as the destination. If multiple URLs are given, each will be checked out into a subdirectory of `PATH`, with the name of the subdirectory being the basename of the URL.

## Alternate names

co

## Changes

Creates a working copy

## Accesses repository

Yes

## Options

    --depth ARG
    --force
    --ignore-externals
    --quiet (-q)
    --revision (-r) REV

## Examples

Check out a working copy into a directory called `mine`:

    $ svn checkout file:///var/svn/repos/test mine
    A  mine/a
    A  mine/b
    A  mine/c
    A  mine/d
    Checked out revision 20.
    $ ls
    mine

Check out two different directories into two separate working copies:

    $ svn checkout file:///var/svn/repos/test  file:///var/svn/repos/quiz
    A  test/a
    A  test/b
    A  test/c
    A  test/d
    Checked out revision 20.
    A  quiz/l
    A  quiz/m
    Checked out revision 13.
    $ ls
    quiz  test

Check out two different directories into two separate working copies, but place both into a directory called `working-copies`:

    $ svn checkout file:///var/svn/repos/test  file:///var/svn/repos/quiz working-copies
    A  working-copies/test/a
    A  working-copies/test/b
    A  working-copies/test/c
    A  working-copies/test/d
    Checked out revision 20.
    A  working-copies/quiz/l
    A  working-copies/quiz/m
    Checked out revision 13.
    $ ls
    working-copies

If you interrupt a checkout (or something else interrupts your checkout, such as loss of connectivity, etc.), you can restart it either by issuing the identical checkout command again or by updating the incomplete working copy:

    $ svn checkout file:///var/svn/repos/test mine
    A  mine/a
    A  mine/b
    ^C
    svn: The operation was interrupted
    svn: caught SIGINT

    $ svn checkout file:///var/svn/repos/test mine
    A  mine/c
    ^C
    svn: The operation was interrupted
    svn: caught SIGINT

    $ svn update mine
    A  mine/d
    Updated to revision 20.

If you wish to check out some revision other than the most recent one, you can do so by providing the `--revision` (`-r`) option to the svn checkout command:

    $ svn checkout -r 2 file:///var/svn/repos/test mine
    A  mine/a
    Checked out revision 2.

Prev | Up | Next
svn changelist | Home | svn cleanup