Cloud Posse

Geodesic Quick Start

Get up and running quickly with geodesic


Creating a New Project

Name New Project

Geodesic new project should have a name. We recommend to follow this pattern ${stage}.${base_host}.
Set the name to $CLUSTER_NAME environment variable.

Example: - where ${stage} = staging and ${base_host} =

Generate Scaffolding

This will create a new project in your current working directory called $CLUSTER_NAME, complete with Dockerfile and Makefile.


docker run -e CLUSTER_NAME \
           -e DOCKER_IMAGE=cloudposse/${CLUSTER_NAME} \
           -e DOCKER_TAG=dev \
              cloudposse/geodesic:latest -c new-project | tar -xv -C .

Configure Project

Customize project files as necessary. Edit the Dockerfile to reflect your settings. The files are installed to the $CLUSTER_NAME/ folder. We recommend creating a GitHub repo to store this configuration.


Build & Install

Initialize the Build Harness

make init

Build the docker container

make docker/build

Install the wrapper shell

make install

Run the shell

The shell can now be easily started any time by simply running $CLUSTER_NAME, which is a shell script in /usr/local/bin. Make sure this path is in your PATH environment variable.

Authorize on AWS

Config AWS credentials and roles following Authorization


Geodesic use AWS Vault to authorize on AWS so ensure you add source profile name to AWS Vault

Set default profile for geodesic project

Add to you geodesic project Dockerfile :

### Default AWS Profile name
ENV AWS_DEFAULT_PROFILE="example-staging-admin"

Run make docker/build to rebuild container


You can install it on local to do the same for development purpose.
See AWS Vault setup.

Geodesic Quick Start

Get up and running quickly with geodesic