istio.io/content/docs/setup/consul/quick-start/index.md

title	description	weight	keywords
Quick Start on Docker	Quick Start instructions to setup the Istio service mesh with Docker Compose.	10	consul

Quick Start instructions to install and configure Istio in a Docker Compose setup.

Prerequisites

• Docker
• Docker Compose

Installation steps

1. Go to the Istio release page to download the installation file corresponding to your OS. If you are using a macOS or Linux system, you can also run the following command to download and extract the latest release automatically:

   {{< text bash >}} $ curl -L https://git.io/getLatestIstio | sh - {{< /text >}}

2. Extract the installation file and change the directory to the file location. The installation directory contains:

   • Sample applications in samples/
   • The istioctl client binary in the bin/ directory. istioctl is used for creating routing rules and policies.
   • The istio.VERSION configuration file

3. Add the istioctl client to your PATH. For example, run the following command on a macOS or Linux system:

   {{< text bash >}} $ export PATH=$PWD/bin:$PATH {{< /text >}}

4. For Linux users, configure the DOCKER_GATEWAY environment variable

   {{< text bash >}} $ export DOCKER_GATEWAY=172.28.0.1: {{< /text >}}

5. Change directory to the root of the Istio installation directory.

6. Bring up the Istio control plane containers:

   {{< text bash >}} $ docker-compose -f install/consul/istio.yaml up -d {{< /text >}}

7. Confirm that all docker containers are running:

   {{< text bash >}} $ docker ps -a {{< /text >}}

   If the Istio Pilot container terminates, ensure that you run the istioctl context-create command and re-run the command from the previous step.

8. Configure istioctl to use mapped local port for the Istio API server:

   {{< text bash >}} $ istioctl context-create --api-server http://localhost:8080 {{< /text >}}

Deploy your application

You can now deploy your own application or one of the sample applications provided with the installation like Bookinfo.

Since there is no concept of pods in a Docker setup, the Istio sidecar runs in the same container as the application. We will use Registrator to automatically register instances of services in the Consul service registry.

The application must use HTTP/1.1 or HTTP/2.0 protocol for all its HTTP traffic because HTTP/1.0 is not supported.

{{< text bash >}} $ docker-compose -f .yaml up -d {{< /text >}}

Uninstalling

Uninstall Istio core components by removing the docker containers:

{{< text bash >}} $ docker-compose -f install/consul/istio.yaml down {{< /text >}}