Once installed you can type
takeoff to see a full list of commands.
The first command you will likely use is the
takeoff init <folder-name> [blueprint-name] --blueprint-url=<url> --no-default
init command creates a Takeoff workspace, which is essentially a folder. Inside itself it contains two folders,
You run Takeoff commands from the root folder.
When creating an workspace you must pass a folder name that can’t currently exist, and you can also specify a blueprint name which will fetch from the cache (e.g.
my-cool-blueprint), or get from a known remote blueprint (such as
You can also pass
--blueprint-url a url to a git repository or local folder containing a blueprint. For example:
takeoff init myenv --blueprint-url=https://github.com/takeoff-env/takeoff-blueprint-basic takeoff init myenv --blueprint-url=file://blueprints/my-cool-blueprint
--no-default stops the creation of the default workspace and just makes the required folder structure.
These are the commands you can run in the workspace folder.
Lists the workspaces, versions and apps. More information to be added soon.
takeoff start <workspace> [app]
workspace. If you don’t pass a name it will start the default workspace. If you pass
app it will only start that app (e.g.
takeoff start default db).
takeoff stop <workspace>
Stops all apps running in an
takeoff build <workspace>
workspace using the docker compose file.
takeoff destroy <workspace>
workspace. This is non-reversable and will remove the workspace.
takeoff pull <workspace> [app]
Pulls any pre-built images on an
workspace, or you can specify the
takeoff new [project] <blueprint>
Creates a new project in the workspace, using the default if no blueprint name specified.
takeoff blueprint:update [blueprint] <remote> <branch>
Update a blueprint, you can specify the remote name and the branch to pull to
takeoff blueprint:add [blueprint] [git-repo]
Add a new blueprint to the blueprint cache from a remote or local git repo
Helper command to remove ALL docker images, but also support –filter
Helper command to remove ALL docker containers, but also support –filter
Helper command to remove ALL docker volumes, but also support –filter