# Instalar MariaDB via Docker: veja como funciona

Docker é ideal para o rápido uso do MariaDB. Primeiro, baixe uma imagem adequada. Em seguida, configure e inicie o container com as definições desejadas. Assim, você testa ou desenvolve de maneira independente do sistema host, em um ambiente controlado.

## Vantagens dos ambientes Docker MariaDB

Docker oferece uma maneira simples de disponibilizar [MariaDB](https://www.ionos.com/pt-br/digitalguide/servidor/conhecimento/banco-de-dados-mariadb/) em **ambientes isolados**. Você pode iniciar instâncias rapidamente e testar diferentes versões de forma independente. Isso economiza tempo, evita conflitos com instalações locais e cria condições reprodutíveis para desenvolvimento e testes.

## Requisitos

Antes de começar, você deve se certificar de que os seguintes requisitos sejam atendidos:

- Docker já está instalado e em execução no seu sistema
- Acesso a um terminal (Terminal, PowerShell etc.) com direitos de administrador
- Opcional para MariaDB: [Docker Compose](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/tutorial-do-docker-compose/) para configurações mais complexas

## Instalação do MariaDB via Docker: passo a passo

A seguir, mostramos como instalar o MariaDB via Docker em poucos passos. Explicamos detalhadamente como configurar o Docker em nosso [tutorial do Docker](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/tutorial-docker/).

### Passo 1: instalar o Docker

Caso ainda não tenha instalado o Docker, você pode configurá-lo usando o **script de instalação** oficial:

```bash
curl -sSL https://get.docker.com/ | sh
```

Para Windows ou macOS, recomenda-se o **Docker Desktop**. Após a instalação com sucesso, verifique a funcionalidade com:

```bash
docker --version
```

A saída deve mostrar um número de versão, por exemplo, `Docker version 27.5.1, build cb74dfcd`. Se for o caso, você configurou o Docker corretamente.

Dica Em outros tutoriais, descrevemos em detalhe como [instalar Docker no Windows 11](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/docker-windows-11/) e como funciona a instalação do Docker no Windows 10.

### Passo 2: baixar a imagem MariaDB

Agora, baixe a [imagem Docker MariaDB](https://hub.docker.com/_/mariadb "mariadb-Image auf Docker Hub") oficial do **Docker Hub**. Esta imagem contém uma instância completamente pré-configurada do MariaDB.

```bash
docker pull mariadb:latest
```

Caso você prefira uma versão mais específica, você também pode especificá-la explicitamente, por exemplo:

```bash
docker pull mariadb:10.11
```

Você pode então verificar todas as imagens armazenadas localmente com o seguinte comando:

```bash
docker images
```

A linha com `mariadb` e a tag correspondente deve aparecer na lista.

### Passo 3: iniciar o Mariadb Docker Container

Agora, crie o container. Para isso, use o comando:

```bash
docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password -d -p 3306:3306 mariadb:latest
```

- `--name mariadb-container`: atribui ao container um nome específico, pelo qual ele pode ser referenciado no sistema.
- `-e MYSQL_ROOT_PASSWORD=password`: define a senha root do banco de dados MariaDB. Você precisará dela posteriormente para fazer login.
- `-d`: inicia o container em modo de segundo plano (Detached Mode), assim sua console permanece livre.
- `-p 3306:3306`: conecta a porta padrão do banco de dados do container à mesma porta no seu sistema local, permitindo o acesso por clientes.

Após executar este comando, o Docker deve iniciar o container. Para verificar o status, digite:

```bash
docker ps
```

Na lista de containers em execução, o `mariadb-container` deve aparecer com o status `Up`. Se o container não estiver funcionando como esperado, você pode verificar os arquivos de log com:

```bash
docker logs mariadb-container
```

A saída dos logs ajuda você a identificar possíveis erros de configuração.

### Passo 4: estabelecer acesso ao MariaDB

Assim que o container MariaDB Docker estiver em execução, você poderá acessar o banco de dados com um **cliente compatível com MySQL** como a ferramenta padrão do MySQL ou ferramentas gráficas como DBeaver, HeidiSQL ou Beekeeper Studio.

Use, por exemplo, o seguinte comando na linha de comando:

```bash
mysql -h 127.0.0.1 -P 3306 -u root -p
```

Você será solicitado a inserir a senha. Digite a senha que você definiu com `MYSQL_ROOT_PASSWORD`.

Se tudo funcionar, você terá acesso ao console do MariaDB. Lá, você poderá executar **comandos SQL** como de costume:

```sql
SHOW DATABASES;
```

Você verá uma lista das bases de dados padrão e agora pode criar suas próprias bases de dados ou tabelas.

### Passo 5: proteger dados persistentes com volumes

Por padrão, os dados no contêiner são voláteis. Para proteger seus dados em reinicializações ou trocas de contêiner, você deve usar um volume:

```bash
docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password -d \
 -v mariadb_data:/var/lib/mysql \
 -p 3306:3306 mariadb:latest
```

`-v mariadb_data:/var/lib/mysql` cria um volume Docker chamado `mariadb_data` e o vincula ao diretório onde o MariaDB armazena seus dados.

Você pode visualizar os volumes armazenados a qualquer momento com o seguinte comando:

```bash
docker volume ls
```

E com este comando, inspecione o conteúdo de um volume:

```bash
docker volume inspect mariadb_data
```

### Passo 6: gerenciar MariaDB com Docker Compose

Para configurações mais complexas, você deve utilizar o [Docker Compose](https://www.ionos.com/pt-br/digitalguide/servidor/configuracao/tutorial-do-docker-compose/). Para isso, crie um arquivo `docker-compose.yml` com o seguinte conteúdo:

```yaml
version: '3.1'
services:
 mariadb:
  image: mariadb:latest
  container_name: mariadb-compose
  environment:
   MYSQL_ROOT_PASSWORD: password
   MYSQL_DATABASE: example_db
  ports:
   - "3306:3306"
  volumes:
   - mariadb_data:/var/lib/mysql
volumes:
 mariadb_data:
```

Inicie o ambiente com:

```bash
docker-compose up -d
```

Em seguida, o MariaDB funciona continuamente em segundo plano, incluindo armazenamento persistente e banco de dados pré-configurado.

### Passo 7: parar, iniciar e remover o container

A administração de containers é muito fácil com o Docker. Você pode parar ou reiniciar o container do mariadb docker a qualquer momento, sem perda de dados - desde que utilize volumes.

**Parar container:**

```bash
docker stop mariadb-container
```

**Iniciar container:**

```bash
docker start mariadb-container
```

**Remover container:**

```bash
docker rm mariadb-container
```

**Excluir container juntamente com volume:**

```bash
docker rm -v mariadb-container
```

### Passo 8: reinício automático do container

Para garantir que seu container de MariaDB Docker reinicie automaticamente após uma reinicialização do sistema host, você pode definir a política de reinício (Restart-Policy):

```bash
docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password \ 
 -v mariadb_data:/var/lib/mysql \ 
 -p 3306:3306 \ 
 --restart unless-stopped \ 
 -d mariadb:latest
```

`--restart unless-stopped` garante que o container inicie automaticamente após uma reinicialização do sistema, a menos que você o tenha parado manualmente.

Dica Em nosso guia, você também aprenderá como [configurar MariaDB via Kubernetes](https://www.ionos.com/pt-br/digitalguide/hospedagem/tecnologia-de-hospedagem/mariadb-via-kubernetes/) e instalar MariaDB no Proxmox.


This is a markdown version of: [https://www.ionos.com/pt-br/digitalguide/hospedagem/tecnologia-de-hospedagem/mariadb-via-docker/](https://www.ionos.com/pt-br/digitalguide/hospedagem/tecnologia-de-hospedagem/mariadb-via-docker/) for AI/LLM consumption.