• 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

    --revision (-r) REV
    --quiet (-q)
    --non-recursive (-N)
    --username USER
    --password PASS
    --no-auth-cache
    --non-interactive
    --ignore-externals
    --config-dir DIR
    

    Examples

    Check out a working copy into a directory called mine:

    $ svn checkout file:///tmp/repos/test mine
    A  mine/a
    A  mine/b
    Checked out revision 2.
    $ ls
    mine
    

    Check out two different directories into two separate working copies:

    $ svn checkout file:///tmp/repos/test  file:///tmp/repos/quiz
    A  test/a
    A  test/b
    Checked out revision 2.
    A  quiz/l
    A  quiz/m
    Checked out revision 2.
    $ 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:///tmp/repos/test  file:///tmp/repos/quiz working-copies
    A  working-copies/test/a
    A  working-copies/test/b
    Checked out revision 2.
    A  working-copies/quiz/l
    A  working-copies/quiz/m
    Checked out revision 2.
    $ ls
    working-copies
    

    If you interrupt a checkout (or something else interrupts your checkout, like 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:///tmp/repos/test test
    A  test/a
    A  test/b
    ^C
    svn: The operation was interrupted
    svn: caught SIGINT
    
    $ svn checkout file:///tmp/repos/test test
    A  test/c
    A  test/d
    ^C
    svn: The operation was interrupted
    svn: caught SIGINT
    
    $ cd test
    $ svn update
    A  test/e
    A  test/f
    Updated to revision 3.
    

    The Version Control with Subversion book is licensed under the Creative Commons Attribution License v2.0.
    To submit comments, corrections, or other contributions to the text, please visit http://www.svnbook.com.