diff --git a/README.md b/README.md index d12f9875f..387650e52 100644 --- a/README.md +++ b/README.md @@ -46,25 +46,34 @@ Citus Cloud runs on top of AWS as a fully managed database as a service and has If you're looking to get started locally, you can follow the following steps to get up and running. -* Install docker-compose: [Mac][mac_install] | [Linux][linux_install] -* (Mac only) connect to Docker VM - ```bash - eval $(docker-machine env default) - ``` +1. Install Docker Community Edition and Docker Compose + * Mac: + 1. [Download](https://www.docker.com/community-edition#/download) and install Docker. + 2. Start Docker by clicking on the application’s icon. + * Linux: + ```bash + curl -sSL https://get.docker.com/ | sh + sudo usermod -aG docker $USER && exec sg docker newgrp `id -gn` + sudo systemctl start docker -* Pull and start the docker images + sudo curl -sSL https://github.com/docker/compose/releases/download/1.11.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose + sudo chmod +x /usr/local/bin/docker-compose + ``` + The above version of Docker Compose is sufficient for running Citus, or you can install the [latest version](https://github.com/docker/compose/releases/latest). + +1. Pull and start the Docker images ```bash - wget https://raw.githubusercontent.com/citusdata/docker/master/docker-compose.yml + curl -sSLO https://raw.githubusercontent.com/citusdata/docker/master/docker-compose.yml docker-compose -p citus up -d ``` -* Connect to the master database +1. Connect to the master database ```bash - docker exec -it citus_master psql -U postgres -d postgres + docker exec -it citus_master psql -U postgres ``` -* Follow the [first tutorial][tutorial] instructions -* To shut the cluster down, run +1. Follow the [first tutorial][tutorial] instructions +1. To shut the cluster down, run ```bash docker-compose -p citus down @@ -78,7 +87,7 @@ If you're looking to get started locally, you can follow the following steps to