How To Install and Use Docker Compose on Ubuntu 18.04
Docker Compose is a tool that allows you to define and manage multi-container Docker applications. It uses a YAML file to configure the application’s services, networks and volumes.
Compose can be used for different purposes. Single host application deployments, automated testing and local development are the most popular use cases for Docker Compose.
In this tutorial we’ll show you how to install the latest version of Docker Compose on Ubuntu 18.04 and explore the basic Docker Compose concepts and commands.
The same instructions apply for Ubuntu 16.04 and any other Debian based distribution, including Debian, Linux Mint and Elementary OS.
Prerequisites
Make sure that you have met the following prerequisites before continuing with this tutorial:
- Logged in as a user with sudo privileges.
- Have Docker installed following the instructions from How To Install and Use Docker on Ubuntu 18.04.
Install Docker Compose on Ubuntu
The Docker Compose installation package is available in the official Ubuntu 18.04 repositories but it may not always be the latest version. The recommended approach is to install Docker Compose from the Docker’s GitHub repository.
At the time of writing this article, the latest stable version of Docker Compose is version 1.23.1
. Before downloading the Compose binary visit the Compose repository release page on GitHub and check if there is a new version available for download.
To install Docker Compose on Ubuntu 18.04, follow these steps:
- Download the Docker Compose binary into the
/usr/local/bin
directory with the following curl command:
sudo curl -L "https://github.com/docker/compose/releases/download/1.23.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
Copy
- Once the download is complete, apply executable permissions to the Compose binary:
sudo chmod +x /usr/local/bin/docker-compose
Copy
- Verify the installation by running the following command which will display the Compose version:
docker-compose --version
Copy
The output will look something like this:
docker-compose version 1.23.1, build b02f1306
Copy
Getting started with Docker Compose
In this section we will show how to use Docker Compose to setup a multi-container WordPress application on your Ubuntu 18.04 machine.
Start by creating a project directory and navigating into it:
mkdir my_appcd my_app
Copy
Launch your text editor and create a file named docker-compose.yml
inside the project directory:
nano docker-compose.yml
Copy
Paste the following content:
docker-compose.yml
version: '3.3'
services:
db:
image: mysql:5.7
restart: always
volumes:
- db_data:/var/lib/mysql
environment:
MYSQL_ROOT_PASSWORD: password
MYSQL_DATABASE: wordpress
wordpress:
image: wordpress
restart: always
volumes:
- ./wp_data:/var/www/html
ports:
- "8080:80"
environment:
WORDPRESS_DB_HOST: db:3306
WORDPRESS_DB_NAME: wordpress
WORDPRESS_DB_USER: root
WORDPRESS_DB_PASSWORD: password
depends_on:
- db
volumes:
db_data:
wp_data:
Copy
Let’s analyze the code line by line.
In the first line we are specifying the Compose file version. There are several different versions of the Compose file format with support for specific Docker releases.
Next we are defining two services, db
and wordpress
. Each service runs one image and it will create a separate container when docker-compose is run.
The db
service:
- Uses the mysql:5.7 image. In the image is not present on your system Compose will pull it from the Docker Hub public repository.
- Uses the restart
always
policy which will instruct the container to always restart. - Creates a named volume
db_data
to persist the database. - Defines the environment variables for the
mysql:5.7
image.
The wordpress
service:
- Uses the wordpress image. In the image is not present on your system Compose will pull it from the Docker Hub public repository.
- Uses the restart
always
policy which will instruct the container to always restart. - Mounts the
wp_data
directory on the host to/var/lib/mysql
inside the container. - Forwards the exposed port 80 on the container to port 8080 on the host machine.
- Defines the environment variables for the
wordpress
image. - The
depends_on
instruction defines the dependency between the two services. In this example,db
will be started beforewordpress
.
From the project directory, start up the WordPress application by running the following command:
docker-compose up
Copy
The output should look something like this:
...
wordpress_1 | [Sun Sep 23 22:31:43.499055 2018] [mpm_prefork:notice] [pid 1] AH00163: Apache/2.4.25 (Debian) PHP/7.2.10 configured -- resuming normal operations
wordpress_1 | [Sun Sep 23 22:31:43.499796 2018] [core:notice] [pid 1] AH00094: Command line: 'apache2 -D FOREGROUND'
Copy
Compose will pull both images, start two containers and create the wp_data
directory in your project directory.
Enter http://0.0.0.0:8080/
in your browser and you will see the Wordpress installation screen.
At this point the Wordpress application is up and running and you can start working your theme or plugin.
To stop Compose press CTRL+C
.
You can also start the Compose in a detached mode by passing the -d
flag.
docker-compose up -d
Copy
To check the running services use the ps
option:
docker-compose ps
Copy
Name Command State Ports
----------------------------------------------------------------------------------
my_app_db_1 docker-entrypoint.sh mysqld Up 3306/tcp, 33060/tcp
my_app_wordpress_1 docker-entrypoint.sh apach ... Up 0.0.0.0:8080->80/tcp
Copy
When Compose is running in detached mode to stop the services use:
docker-compose stop
Copy
If you want to remove the containers entirely use the down
option:
docker-compose down
Copy
Passing the --volumes
switch will also remove the data volumes:
docker-compose down --volumes
Copy
Uninstalling Docker Compose
If for any reason you want to uninstall Docker Compose you can simply delete the binary by typing:
sudo rm /usr/local/bin/docker-compose
Copy
Conclusion
You have learned how to install and use Docker Compose on Ubuntu 18.04. If you have any question, please leave a comment below.