<!--
  canonical-url: https://www.avonture.be/blog/docker-joomla-right-to-the-point
  published:     2024-10-03
  This is a static plain-Markdown mirror generated at build time.
  Visit the canonical URL above for the fully rendered page, with images and interactive components.
-->

# Start Joomla with Docker in just a few clicks

> Start your Joomla website with Docker in just a few clicks! Follow this quick, right-to-the-point guide to launch your Joomla project instantly using a simple Docker Compose setup.

---
![Start Joomla with Docker in just a few clicks](/img/v2/joomla.webp)

**TL;DR**

This is a minimal, no-frills guide to launching Joomla with Docker: copy the official `compose.yaml` snippet from Docker Hub, run `docker compose up --detach`, and log into `http://127.0.0.1:8080/administrator` with the default `joomla`/`joomla@secured` credentials defined in that file.

Yesterday at lunchtime, while chatting with a friend, he challenged me with a simple request: explain the easiest way in the world to start a Joomla project with Docker.

The aim is to hop, hop, copy/paste a file, hop, Joomla is launched and you can start playing with the site.

*Three things you'll want soon after: a [volume](/blog/docker-volume) so the site survives a `docker compose down`, [Adminer or phpmyadmin](/blog/docker-adminer-pgadmin-phpmyadmin) to look inside the database, and [Update php.ini when using a Docker image](/blog/docker-php-ini) the day Joomla refuses your file upload as being too large.*

Let's take a look; not in detail, but right to the point.

**Here are the very few steps to follow to start your Joomla website using Docker:**

1. Surf to <a href="https://hub.docker.com/_/joomla"><https://hub.docker.com/_/joomla></a>

2. Scroll down until you can see the `yaml` content and click on the `Copy` button. That button appears when the mouse pointer is over the text (hidden otherwise)

3. On your computer, create a new file called `compose.yaml` and paste the content there

4. The most difficult part is now: please start a new console, go to the folder where you've just created the file (in my case, I've created the file in my `/tmp/joomla` folder so I jump in it using `cd /tmp/joomla`)

5. Still in your console, please run `docker compose up --detach`.

From now, Docker will download (just the first time) the Joomla CMS, PHP, Apache and MySQL. Then Docker will start the downloaded images (called containers).

Surf to `http://127.0.0.1:8080/administrator` and enjoy!

> Screenshot — http\://127.0.0.1:8080/administrator
>
> ![Joomla administrator](./images/administrator.webp)

> **Caution:**
>
> The admin account to use is `joomla` and its password is `joomla@secured` (as defined in the yaml file you've just copied earlier).

> **Information:**
>
> This article is deliberately simple; please follow the [Joomla](/blog/tags/joomla) tag if you want more than this introduction.
