> For the complete documentation index, see [llms.txt](https://docs.uxwizz.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.uxwizz.com/installation/docker/via-docker-compose.md).

# Via Docker Compose

{% hint style="info" %}
This guide assumes you already have [Docker ](https://www.docker.com/)installed.
{% endhint %}

{% hint style="info" %}
This Docker compose creates two services: 

1. **Webserver** (Apache/PHP)  - The [UXWizz Webserver image](https://hub.docker.com/repository/docker/uxwizz/uxwizz-webserver/general)
2. **Database** (MySQL) - [MariaDB Image](https://hub.docker.com/_/mariadb)
   {% endhint %}

## Running UXWizz via docker compose

Copy this **compose.yml**  file locally in a folder named `uxwizz` and run **`docker compose up -d`**

{% code title="compose.yml" %}

```yaml
services:
  webserver:
    image: uxwizz/uxwizz-webserver:latest
    container_name: "uxwizz-webserver"
    restart: always
    ports:
      - "8000:80"
      - "4430:443"
    volumes:
      - html:/var/www/html
      - php-config:/usr/local/etc/php/php.ini
      - apache_sites_enabled:/etc/apache2/sites-enabled
      - apache_logs:/var/log/apache2
    environment:
      UXWIZZ_DB_HOST: db
      MYSQL_DATABASE: uxwizz
      MYSQL_ROOT_PASSWORD: temp-root-password-jasdlkz1
    depends_on:
      db:
        condition: service_healthy
  db:
    image: mariadb:11.7.2
    container_name: "uxwizz-db"
    ports:
      - "3306:3306"
    command: --max-allowed-packet=64MB --bind-address=0.0.0.0
    environment:
      MYSQL_ROOT_PASSWORD: temp-root-password-jasdlkz1
      MYSQL_DATABASE: uxwizz
      MARIADB_AUTO_UPGRADE: 1
      MARIADB_INITDB_SKIP_TZINFO: 1
    volumes:
      - mysql_data:/var/lib/mysql
    healthcheck:
      test: ["CMD", "healthcheck.sh", "--connect", "--innodb_initialized"]
      start_period: 10s
      interval: 10s
      timeout: 5s
      retries: 3
    restart: always
volumes:
  mysql_data:
  html:
  apache_logs:
  apache_sites_enabled:
  php-config:

```

{% endcode %}

{% hint style="warning" %}
It is recommended to replace both values of **MYSQL\_ROOT\_PASSWORD** with a secure password.
{% endhint %}

To **stop** the services, you can run `docker compose down`.

To also **delete** all UXWizz data/db/volumes, you can run `docker compose down -v`.

## Accessing UXWizz

As shown in the compose file, the ports exported are **8000** (HTTP) and **4430** (HTTPS).\
\
You should now be able to access your dashboard at [**http://localhost:8000**](http://localhost:8000)

## Tip: Using Bind Volumes

If you want to use local folders as bind volumes, instead of named volumes.

You must first populate the **html** folder from the webserver image, by running this command:

```sh
mkdir -p ./html; docker run --rm --entrypoint="" uxwizz/uxwizz-webserver \
tar cf - -C /var/www/html . | tar xf - -C ./html
```

Then, in **compose.yml** prepend **./** to all volumes, like this:

```yaml
services:
...
  webserver:
  ...
    volumes:
      - ./html:/var/www/html
      - ./php.ini:/usr/local/etc/php/php.ini:ro
      - ./sites-enabled:/etc/apache2/sites-enabled
      - ./apache_logs:/var/log/apache2
  db:
  ...
    volumes:
      - ./mysql_data:/var/lib/mysql

```