diff --git a/docs/installation.md b/docs/installation.md index 9bd6f9bef..82f6ddb41 100644 --- a/docs/installation.md +++ b/docs/installation.md @@ -190,25 +190,51 @@ There are four ways to install Pilosa on MacOS: Use [Homebrew](https://brew.sh/) #### Use Docker -1. Install Docker for Mac. +1. Install Docker for your platform. On Linux, Docker is available via your package manager. On MacOS, you can use Docker for Mac or Docker Toolbox. On Windows, you can use Docker for Windows or Docker Toolbox. -2. Confirm that the Docker daemon is running in the background: +2. **This step is necessary only if you are using Docker Toolbox**, otherwise skip to step 3: + + a. Start the Docker support using `docker-machine start` in a terminal. The environment variables of the terminal should be updated accordingly, run `docker-machine env` to display the necessary commands. + + b. Set up port forwarding in the VirtualBox GUI or on the command line. Guest port should be 10101. For the host port, 10101 is recommended. If the `VBoxManage` command is in your `PATH`, you can use the following command (assuming you use the default VM): + + ``` + VBoxManage modifyvm "default" --natpf1 "pilosa,tcp,,10101,,10101" + ``` + +3. Confirm that the Docker daemon is running in the background: ``` docker version ``` - If you don't see the server listed, start the Docker application. + If you are getting a "command not found" or similar, check that `docker` command is in your path. If you don't see the server listed, start the Docker application. + + +4. Pull the official Pilosa image from Docker Hub: -3. Pull the official Pilosa image from Docker Hub: ``` docker pull pilosa/pilosa:latest ``` -4. Make sure Pilosa is installed successfully: +5. Make sure Pilosa is installed successfully, and make it accessible: + ``` - docker run --rm pilosa/pilosa:latest help + docker run -d --rm --name pilosa -p 10101:10101 pilosa/pilosa:latest server --bind 0.0.0.0:10101 ``` +6. Check that it is accessible from outside the container. + + Run the following in a separate terminal: + ``` + curl localhost:10101/schema + ``` + + If that returns `{"indexes":null}` or similar, then Pilosa is accessible from outside the container. Otherwise check that you have correctly typed `-p 10101:10101` when running the Pilosa container and the port mappings in VirtualBox is correct (Docker Toolbox only). + +7. When you want to terminate the Pilosa container, you can run the following: + ``` + docker stop pilosa + ``` #### What's next? Head over to the [Getting Started](../getting-started/) guide to create your first Pilosa index. @@ -366,42 +392,8 @@ There are three ways to install Pilosa on Linux: download the binary (recommende Head over to the [Getting Started](../getting-started/) guide to create your first Pilosa index. - +Windows Subsystem for Linux is currently not supported.