titan clone

Clones a new repository based on a commit from a remote repository. The docker image and data is all derived from that commit, to specify a different docker configuration than what was used when creating the commit pass arguments after --` for context specific runtime arguments. For more information about using the --` arguments, see the titan run section. For more information on managing the docker configuration, see the Managing Docker section.


titan clone [-c id] [-p key=value ...] [-t key=value ...] [-n repository] <uri> -- [additional context specific arguments]...



Required. The URI of the remote to clone from. For more information on remotes, the URI format, and different remote providers, see the Remote Repositories section. Note that due to current limitations, when using a URL with query parameters (for tags), it must be passed after the “–” delimeter, otherwise you will get an error of “no such option”.


-c, --commit

id Specify the commit ID to checkout.

-p, --parameters string

Key=Value pair for provider specific options.

-P, --disable-port-mapping

Default: false. Disable the automatic specific port mapping of exposed ports from the container to localhost.

-t, --tag

key=value Optional tags to filter commits when finding the latest commit. Generates an error if no matching commit is found, or if an explicit commit ID is specified.

-n, --name

TEXT Optional. Name of the new repository to create. If not specified, then the name of the original repository is used (which may or may not match the name used in the remote URI).


$ titan clone -n myrepo s3web://demo.titan-data.io/hello-world/postgres
Creating repository myrepo
Creating docker volume myrepo/v0 with path /var/lib/postgresql/data
Running controlled container myrepo
PULL 0f53a6a4-90ff-4f8c-843a-a6cce36f4f4f from origin RUNNING
Pulling 0f53a6a4-90ff-4f8c-843a-a6cce36f4f4f from 'origin'
Downloading archive for /var/lib/postgresql/data
PULL 0f53a6a4-90ff-4f8c-843a-a6cce36f4f4f from origin COMPLETE
Stopping container myrepo
Checkout 0f53a6a4-90ff-4f8c-843a-a6cce36f4f4f
Starting container myrepo
0f53a6a4-90ff-4f8c-843a-a6cce36f4f4f checked out