mariadb docker 설치(2025.10.27)

자다말고 일어나서 갑자기 MariaDB Docker 설치를 하고 싶어 정리된 글을 찾다 보니 옛날 자료만 있어서 갱신차원에서 적어 봅니다.

- port랑 접속 설정 추가(2025.10.28)

 

어려운 내용은 아니고 바뀐 부분만 알고 있으면 쉬운 내용인데 찾아 다니기 귀찮아서 최신화 글을 적어 봅니다.

 

참고원문글

https://hub.docker.com/_/mariadb

mariadb - Official Image | Docker Hub

 

일단 기존 마리아디비를 사용하신 적이 있다면 도커로 오면서 MSSQL에서 MARIA로 명칭이 조금 바뀐 내용이 있다는 것은 기억할 듯 싶은데 정확한 내용을 찾아 왔을 것이라 생각합니다. 

일단 저도 가끔 셋팅하다보면 외워서 사용하는 것들이 아니라서 주기적으로 찾아보거나 있던거 사용해서... 사실은 오류가 나면 찾아 보고있습니다.

자다가 일어나서 오류를 보고 싶지는 않아서 찾아서 정리하고 한방에 해볼까해서 적어봅니다. 

1. 우선 도커 사용 기본 설명

포트는 호스트포트:도커내부포트

도커끼리 연결할때는 네트워크 명칭을 생성해서 묶어서 사용

볼륨정할때 호스트폴더경로:도커내부경로

env 옵션으로 내부 시스템 설정 지정 ex) --env MARIADB_ROOT_PASSWORD=my-secret-pw

2. 설명없이 바로 기본설정하고 실행하기

** 실행문 **

$ docker network create dockernet01 

$ docker run --detach --network dockernet01 -p 8306:3306 --name mariadb01 --env MARIADB_USER=firstuser --env MARIADB_PASSWORD=userpass --env MARIADB_ROOT_PASSWORD=ospass mariadb:latest

# 도커 접속
$ docker exec -it mariadb01 bash

# 버전확인 ( 오늘확인한 lastest 버전은 12.0.2 버전으로 설치되네요 )
$ mariadb --version
# or 구버전
$ mysql --version

#데이터베이스 접속하기
$ mariadb -u firstuser -p
# or 구버전
$ mysql -u [사용자명] -p

# 원격 접속 허용 설정하기
$ docker exec -it mariadb01 bash
$ mariadb -u root -p  
# pass: ospass
$ grant all privileges on *.* to 'firstuser'@'%';
$ flush privileges;

# localhost:8306 접속

---

참고1. 마리아DB 실행시 유저, 패스워드, 데이타베이스 생성하고 도커 실행바로 하기

$ docker run --detach --name some-mariadb --env MARIADB_USER=example-user --env MARIADB_PASSWORD=my_cool_secret --env MARIADB_DATABASE=exmple-database --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest

 

참고2. 로컬 도커 네트워크 묶어서 마리아DB실행

$ docker network create some-network 

$ docker run --detach --network some-network --name some-mariadb --env MARIADB_USER=example-user --env MARIADB_PASSWORD=my_cool_secret --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest

$ docker run --detach --network some-network --name some-application --env APP_DB_HOST=some-mariadb --env APP_DB_USER=example-user --env APP_DB_PASSWD=my_cool_secret some-application

 

3. 마리아디비 도커 실행 기본

최소 실행

$ docker run --detach --name some-mariadb --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest
or:

$ docker run --detach --name some-mariadb --env MARIADB_ALLOW_EMPTY_ROOT_PASSWORD=1 mariadb:latest
or:

$ docker run --detach --name some-mariadb --env MARIADB_RANDOM_ROOT_PASSWORD=1 mariadb:latest

 

compose.yaml 파일

# Use root/example as user/password credentials

services:

  db:
    image: mariadb
    restart: always
    environment:
      MARIADB_ROOT_PASSWORD: example

  adminer:
    image: adminer
    restart: always
    ports:
      - 8080:8080

 

호스트 볼륨 연결( -v 호스트볼륨:/var/lib/mysql:Z)

$ docker run --name some-mariadb -v /my/own/datadir:/var/lib/mysql:Z -e MARIADB_ROOT_PASSWORD=my-secret-pw -d mariadb:latest

이전과 변경점 보고 싶은 분들을 위해..

2023.07.11 - [database/mariadb] - mariadb docker 설치(2023.07.11)

mariadb docker 설치(2023.07.11)