The bootstrap command

git teleport bootstrap <directory>

Creates a new Mirror Set in <directory>. The specified <directory> must not exist. If necessary, a new a Git repository is initialized to hold the Mirror Set.

If you run git teleport bootstrap site_one, the freshly-created Mirror Set will contain the following:

site_one/
├── .gitignore
├── Beamdownfile
└── Beamdownstate/
    └── (initially empty)

Populate the Beamdownfile with the list of repositories to send. The template file contains basic instructions. Commit your changes. Then run git teleport pack to prepare your first set of bundles for sending.

Sample Beamdownfile

# Beamdownfile for Mirroring Git-Teleport Itself

# Repository root prefixes start with "!"
!https://gitlab.com/git-teleport

# URLs are repositories to mirror
https://gitlab.com/git-teleport/git-teleport.git

# The relative URL of each repository in the mirror is its full
# absolute URL with any matching root prefix stripped off.

Multiple Mirror Sets in One Git Repository

If you bootstrap a directory within an existing repository, git-teleport will re-use that repository for your new Mirror Set. If you send bundles to many places, you can store them all within a single repository to keep them together. For example:

git init my_mirror_set
git teleport bootstrap my_mirror_set/site_one
git teleport bootstrap my_mirror_set/site_two

creates the following:

my_mirror_set/
├── .git/
│
├── site_one/
│   ├── Beamdownfile
│   └── Beamdownstate/
│
└── site_two/
    ├── Beamdownfile
    └── Beamdownstate/

Be sure to cd my_mirror_set/site_one to select the Mirror Set you would like to use.