docker-documentation/images/docker-mariadb/index.html

<!doctype html><html lang=en class=no-js> <head><meta charset=utf-8><meta name=viewport content="width=device-width,initial-scale=1"><meta name=description content="Welcome to the home of the LinuxServer.io documentation!"><meta name=author content=LinuxServer.io><link href=https://docs.linuxserver.io/images/docker-mariadb/ rel=canonical><link href=../docker-lychee/ rel=prev><link href=../docker-mastodon/ rel=next><link rel=icon href="https://gblobscdn.gitbook.com/spaces%2F-LWuIse8qFJj2MqDi90T%2Favatar-1590244439115.png?alt=media"><meta name=generator content="mkdocs-1.4.3, mkdocs-material-9.1.16"><title>mariadb - LinuxServer.io</title><link rel=stylesheet href=../../assets/stylesheets/main.26e3688c.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.ecc896b0.min.css><link rel=preconnect href=https://fonts.gstatic.com crossorigin><link rel=stylesheet href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback"><style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style><script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script></head> <body dir=ltr data-md-color-scheme=default data-md-color-primary=purple data-md-color-accent=indigo> <script>var palette=__md_get("__palette");if(palette&&"object"==typeof palette.color)for(var key of Object.keys(palette.color))document.body.setAttribute("data-md-color-"+key,palette.color[key])</script> <input class=md-toggle data-md-toggle=drawer type=checkbox id=__drawer autocomplete=off> <input class=md-toggle data-md-toggle=search type=checkbox id=__search autocomplete=off> <label class=md-overlay for=__drawer></label> <div data-md-component=skip> <a href=#linuxservermariadb class=md-skip> Skip to content </a> </div> <div data-md-component=announce> </div> <header class="md-header md-header--shadow" data-md-component=header> <nav class="md-header__inner md-grid" aria-label=Header> <a href=../.. title=LinuxServer.io class="md-header__button md-logo" aria-label=LinuxServer.io data-md-component=logo> <img src="https://gblobscdn.gitbook.com/spaces%2F-LWuIse8qFJj2MqDi90T%2Favatar-1590244439115.png?alt=media" alt=logo> </a> <label class="md-header__button md-icon" for=__drawer> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg> </label> <div class=md-header__title data-md-component=header-title> <div class=md-header__ellipsis> <div class=md-header__topic> <span class=md-ellipsis> LinuxServer.io </span> </div> <div class=md-header__topic data-md-component=header-topic> <span class=md-ellipsis> mariadb </span> </div> </div> </div> <form class=md-header__option data-md-component=palette> <input class=md-option data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme=default data-md-color-primary=purple data-md-color-accent=indigo aria-label="Switch to dark mode" type=radio name=__palette id=__palette_1> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_2 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M17 6H7c-3.31 0-6 2.69-6 6s2.69 6 6 6h10c3.31 0 6-2.69 6-6s-2.69-6-6-6zm0 10H7c-2.21 0-4-1.79-4-4s1.79-4 4-4h10c2.21 0 4 1.79 4 4s-1.79 4-4 4zM7 9c-1.66 0-3 1.34-3 3s1.34 3 3 3 3-1.34 3-3-1.34-3-3-3z"/></svg> </label> <input class=md-option data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme=slate data-md-color-primary=purple data-md-color-accent=indigo aria-label="Switch to light mode" type=radio name=__palette id=__palette_2> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M17 7H7a5 5 0 0 0-5 5 5 5 0 0 0 5 5h10a5 5 0 0 0 5-5 5 5 0 0 0-5-5m0 8a3 3 0 0 1-3-3 3 3 0 0 1 3-3 3 3 0 0 1 3 3 3 3 0 0 1-3 3Z"/></svg> </label> </form> <label class="md-header__button md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg> </label> <div class=md-search data-md-component=search role=dialog> <label class=md-search__overlay for=__search></label> <div class=md-search__inner role=search> <form class=md-search__form name=search> <input type=text class=md-search__input name=query aria-label=Search placeholder=Search autocapitalize=off autocorrect=off autocomplete=off spellcheck=false data-md-component=search-query required> <label class="md-search__icon md-icon" for=__search> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg> </label> <nav class=md-search__options aria-label=Search> <button type=reset class="md-search__icon md-icon" title=Clear aria-label=Clear tabindex=-1> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg> </button> </nav> </form> <div class=md-search__output> <div class=md-search__scrollwrap data-md-scrollfix> <div class=md-search-result data-md-component=search-result> <div class=md-search-result__meta> Initializing search </div> <ol class=md-search-result__list role=presentation></ol> </div> </div> </div> </div> </div> <div class=md-header__source> <a href=https://github.com/linuxserver/docker-documentation title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> </div> <div class=md-source__repository> linuxserver/docker-documentation </div> </a> </div> </nav> </header> <div class=md-container data-md-component=container> <main class=md-main data-md-component=main> <div class="md-main__inner md-grid"> <div class="md-sidebar md-sidebar--primary" data-md-component=sidebar data-md-type=navigation> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--primary" aria-label=Navigation data-md-level=0> <label class=md-nav__title for=__drawer> <a href=../.. title=LinuxServer.io class="md-nav__button md-logo" aria-label=LinuxServer.io data-md-component=logo> <img src="https://gblobscdn.gitbook.com/spaces%2F-LWuIse8qFJj2MqDi90T%2Favatar-1590244439115.png?alt=media" alt=logo> </a> LinuxServer.io </label> <div class=md-nav__source> <a href=https://github.com/linuxserver/docker-documentation title="Go to repository" class=md-source data-md-component=source> <div class="md-source__icon md-icon"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg> </div> <div class=md-source__repository> linuxserver/docker-documentation </div> </a> </div> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../.. class=md-nav__link> Introduction </a> </li> <li class=md-nav__item> <a href=../../FAQ/ class=md-nav__link> FAQ </a> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_3> <label class=md-nav__link for=__nav_3 id=__nav_3_label tabindex=0> General <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_3_label aria-expanded=false> <label class=md-nav__title for=__nav_3> <span class="md-nav__icon md-icon"></span> General </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../general/container-execution/ class=md-nav__link> Container Execution </a> </li> <li class=md-nav__item> <a href=../../general/containers-101/ class=md-nav__link> Docker Containers: 101 </a> </li> <li class=md-nav__item> <a href=../../general/running-our-containers/ class=md-nav__link> Running LinuxServer Containers </a> </li> <li class=md-nav__item> <a href=../../general/container-customization/ class=md-nav__link> Customizing LinuxServer Containers </a> </li> <li class=md-nav__item> <a href=../../general/docker-compose/ class=md-nav__link> Docker Compose </a> </li> <li class=md-nav__item> <a href=../../general/understanding-puid-and-pgid/ class=md-nav__link> Understanding PUID and PGID </a> </li> <li class=md-nav__item> <a href=../../general/updating-our-containers/ class=md-nav__link> Updating our containers </a> </li> <li class=md-nav__item> <a href=../../general/volumes/ class=md-nav__link> Volumes </a> </li> <li class=md-nav__item> <a href=../../general/fleet/ class=md-nav__link> Fleet </a> </li> <li class=md-nav__item> <a href=../../general/swag/ class=md-nav__link> SWAG </a> </li> <li class=md-nav__item> <a href=../../general/awesome-lsio/ class=md-nav__link> Awesome LSIO </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--active md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_4 checked> <label class=md-nav__link for=__nav_4 id=__nav_4_label tabindex=0> Images <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_4_label aria-expanded=true> <label class=md-nav__title for=__nav_4> <span class="md-nav__icon md-icon"></span> Images </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../docker-adguardhome-sync/ class=md-nav__link> adguardhome-sync </a> </li> <li class=md-nav__item> <a href=../docker-airsonic-advanced/ class=md-nav__link> airsonic-advanced </a> </li> <li class=md-nav__item> <a href=../docker-airsonic/ class=md-nav__link> airsonic </a> </li> <li class=md-nav__item> <a href=../docker-apprise-api/ class=md-nav__link> apprise-api </a> </li> <li class=md-nav__item> <a href=../docker-audacity/ class=md-nav__link> audacity </a> </li> <li class=md-nav__item> <a href=../docker-babybuddy/ class=md-nav__link> babybuddy </a> </li> <li class=md-nav__item> <a href=../docker-bazarr/ class=md-nav__link> bazarr </a> </li> <li class=md-nav__item> <a href=../docker-beets/ class=md-nav__link> beets </a> </li> <li class=md-nav__item> <a href=../docker-blender/ class=md-nav__link> blender </a> </li> <li class=md-nav__item> <a href=../docker-boinc/ class=md-nav__link> boinc </a> </li> <li class=md-nav__item> <a href=../docker-booksonic-air/ class=md-nav__link> booksonic-air </a> </li> <li class=md-nav__item> <a href=../docker-booksonic/ class=md-nav__link> booksonic </a> </li> <li class=md-nav__item> <a href=../docker-bookstack/ class=md-nav__link> bookstack </a> </li> <li class=md-nav__item> <a href=../docker-budge/ class=md-nav__link> budge </a> </li> <li class=md-nav__item> <a href=../docker-build-agent/ class=md-nav__link> build-agent </a> </li> <li class=md-nav__item> <a href=../docker-calibre-web/ class=md-nav__link> calibre-web </a> </li> <li class=md-nav__item> <a href=../docker-calibre/ class=md-nav__link> calibre </a> </li> <li class=md-nav__item> <a href=../docker-cardigann/ class=md-nav__link> cardigann </a> </li> <li class=md-nav__item> <a href=../docker-changedetection.io/ class=md-nav__link> changedetection.io </a> </li> <li class=md-nav__item> <a href=../docker-chevereto/ class=md-nav__link> chevereto </a> </li> <li class=md-nav__item> <a href=../docker-chromium/ class=md-nav__link> chromium </a> </li> <li class=md-nav__item> <a href=../docker-clarkson/ class=md-nav__link> clarkson </a> </li> <li class=md-nav__item> <a href=../docker-cloud9/ class=md-nav__link> cloud9 </a> </li> <li class=md-nav__item> <a href=../docker-code-server/ class=md-nav__link> code-server </a> </li> <li class=md-nav__item> <a href=../docker-codiad/ class=md-nav__link> codiad </a> </li> <li class=md-nav__item> <a href=../docker-codimd/ class=md-nav__link> codimd </a> </li> <li class=md-nav__item> <a href=../docker-cops/ class=md-nav__link> cops </a> </li> <li class=md-nav__item> <a href=../docker-couchpotato/ class=md-nav__link> couchpotato </a> </li> <li class=md-nav__item> <a href=../docker-daapd/ class=md-nav__link> daapd </a> </li> <li class=md-nav__item> <a href=../docker-darktable/ class=md-nav__link> darktable </a> </li> <li class=md-nav__item> <a href=../docker-davos/ class=md-nav__link> davos </a> </li> <li class=md-nav__item> <a href=../docker-ddclient/ class=md-nav__link> ddclient </a> </li> <li class=md-nav__item> <a href=../docker-deluge/ class=md-nav__link> deluge </a> </li> <li class=md-nav__item> <a href=../docker-digikam/ class=md-nav__link> digikam </a> </li> <li class=md-nav__item> <a href=../docker-dillinger/ class=md-nav__link> dillinger </a> </li> <li class=md-nav__item> <a href=../docker-diskover/ class=md-nav__link> diskover </a> </li> <li class=md-nav__item> <a href=../docker-docker-compose/ class=md-nav__link> docker-compose </a> </li> <li class=md-nav__item> <a href=../docker-dokuwiki/ class=md-nav__link> dokuwiki </a> </li> <li class=md-nav__item> <a href=../docker-domoticz/ class=md-nav__link> domoticz </a> </li> <li class=md-nav__item> <a href=../docker-doplarr/ class=md-nav__link> doplarr </a> </li> <li class=md-nav__item> <a href=../docker-doublecommander/ class=md-nav__link> doublecommander </a> </li> <li class=md-nav__item> <a href=../docker-duckdns/ class=md-nav__link> duckdns </a> </li> <li class=md-nav__item> <a href=../docker-duplicati/ class=md-nav__link> duplicati </a> </li> <li class=md-nav__item> <a href=../docker-emby/ class=md-nav__link> emby </a> </li> <li class=md-nav__item> <a href=../docker-embystat/ class=md-nav__link> embystat </a> </li> <li class=md-nav__item> <a href=../docker-emulatorjs/ class=md-nav__link> emulatorjs </a> </li> <li class=md-nav__item> <a href=../docker-endlessh/ class=md-nav__link> endlessh </a> </li> <li class=md-nav__item> <a href=../docker-fail2ban/ class=md-nav__link> fail2ban </a> </li> <li class=md-nav__item> <a href=../docker-feed2toot/ class=md-nav__link> feed2toot </a> </li> <li class=md-nav__item> <a href=../docker-ffmpeg/ class=md-nav__link> ffmpeg </a> </li> <li class=md-nav__item> <a href=../docker-filezilla/ class=md-nav__link> filezilla </a> </li> <li class=md-nav__item> <a href=../docker-firefox/ class=md-nav__link> firefox </a> </li> <li class=md-nav__item> <a href=../docker-fleet/ class=md-nav__link> fleet </a> </li> <li class=md-nav__item> <a href=../docker-foldingathome/ class=md-nav__link> foldingathome </a> </li> <li class=md-nav__item> <a href=../docker-freshrss/ class=md-nav__link> freshrss </a> </li> <li class=md-nav__item> <a href=../docker-github-desktop/ class=md-nav__link> github-desktop </a> </li> <li class=md-nav__item> <a href=../docker-gitqlient/ class=md-nav__link> gitqlient </a> </li> <li class=md-nav__item> <a href=../docker-grav/ class=md-nav__link> grav </a> </li> <li class=md-nav__item> <a href=../docker-grocy/ class=md-nav__link> grocy </a> </li> <li class=md-nav__item> <a href=../docker-guacd/ class=md-nav__link> guacd </a> </li> <li class=md-nav__item> <a href=../docker-habridge/ class=md-nav__link> habridge </a> </li> <li class=md-nav__item> <a href=../docker-headphones/ class=md-nav__link> headphones </a> </li> <li class=md-nav__item> <a href=../docker-healthchecks/ class=md-nav__link> healthchecks </a> </li> <li class=md-nav__item> <a href=../docker-hedgedoc/ class=md-nav__link> hedgedoc </a> </li> <li class=md-nav__item> <a href=../docker-heimdall/ class=md-nav__link> heimdall </a> </li> <li class=md-nav__item> <a href=../docker-hishtory-server/ class=md-nav__link> hishtory-server </a> </li> <li class=md-nav__item> <a href=../docker-homeassistant/ class=md-nav__link> homeassistant </a> </li> <li class=md-nav__item> <a href=../docker-htpcmanager/ class=md-nav__link> htpcmanager </a> </li> <li class=md-nav__item> <a href=../docker-ipfs/ class=md-nav__link> ipfs </a> </li> <li class=md-nav__item> <a href=../docker-jackett/ class=md-nav__link> jackett </a> </li> <li class=md-nav__item> <a href=../docker-jellyfin/ class=md-nav__link> jellyfin </a> </li> <li class=md-nav__item> <a href=../docker-kanzi/ class=md-nav__link> kanzi </a> </li> <li class=md-nav__item> <a href=../docker-kasm/ class=md-nav__link> kasm </a> </li> <li class=md-nav__item> <a href=../docker-kdenlive/ class=md-nav__link> kdenlive </a> </li> <li class=md-nav__item> <a href=../docker-lazylibrarian/ class=md-nav__link> lazylibrarian </a> </li> <li class=md-nav__item> <a href=../docker-ldap-auth/ class=md-nav__link> ldap-auth </a> </li> <li class=md-nav__item> <a href=../docker-libreoffice/ class=md-nav__link> libreoffice </a> </li> <li class=md-nav__item> <a href=../docker-libresonic/ class=md-nav__link> libresonic </a> </li> <li class=md-nav__item> <a href=../docker-librespeed/ class=md-nav__link> librespeed </a> </li> <li class=md-nav__item> <a href=../docker-lidarr/ class=md-nav__link> lidarr </a> </li> <li class=md-nav__item> <a href=../docker-limnoria/ class=md-nav__link> limnoria </a> </li> <li class=md-nav__item> <a href=../docker-lollypop/ class=md-nav__link> lollypop </a> </li> <li class=md-nav__item> <a href=../docker-lychee/ class=md-nav__link> lychee </a> </li> <li class="md-nav__item md-nav__item--active"> <input class="md-nav__toggle md-toggle" type=checkbox id=__toc> <label class="md-nav__link md-nav__link--active" for=__toc> mariadb <span class="md-nav__icon md-icon"></span> </label> <a href=./ class="md-nav__link md-nav__link--active"> mariadb </a> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#supported-architectures class=md-nav__link> Supported Architectures </a> </li> <li class=md-nav__item> <a href=#application-setup class=md-nav__link> Application Setup </a> <nav class=md-nav aria-label="Application Setup"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#loading-passwords-and-users-from-files class=md-nav__link> Loading passwords and users from files </a> </li> <li class=md-nav__item> <a href=#bootstrapping-a-new-instance class=md-nav__link> Bootstrapping a new instance </a> </li> <li class=md-nav__item> <a href=#check-and-repair class=md-nav__link> Check and Repair </a> </li> <li class=md-nav__item> <a href=#upgrading class=md-nav__link> Upgrading </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#usage class=md-nav__link> Usage </a> <nav class=md-nav aria-label=Usage> <ul class=md-nav__list> <li class=md-nav__item> <a href=#docker-compose-recommended-click-here-for-more-info class=md-nav__link> docker-compose (recommended, click here for more info) </a> </li> <li class=md-nav__item> <a href=#docker-cli-click-here-for-more-info class=md-nav__link> docker cli (click here for more info) </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#parameters class=md-nav__link> Parameters </a> <nav class=md-nav aria-label=Parameters> <ul class=md-nav__list> <li class=md-nav__item> <a href=#ports-p class=md-nav__link> Ports (-p) </a> </li> <li class=md-nav__item> <a href=#environment-variables-e class=md-nav__link> Environment Variables (-e) </a> </li> <li class=md-nav__item> <a href=#volume-mappings-v class=md-nav__link> Volume Mappings (-v) </a> <nav class=md-nav aria-label="Volume Mappings (-v)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#miscellaneous-options class=md-nav__link> Miscellaneous Options </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#environment-variables-from-files-docker-secrets class=md-nav__link> Environment variables from files (Docker secrets) </a> </li> <li class=md-nav__item> <a href=#umask-for-running-applications class=md-nav__link> Umask for running applications </a> </li> <li class=md-nav__item> <a href=#user-group-identifiers class=md-nav__link> User / Group Identifiers </a> </li> <li class=md-nav__item> <a href=#docker-mods class=md-nav__link> Docker Mods </a> </li> <li class=md-nav__item> <a href=#support-info class=md-nav__link> Support Info </a> </li> <li class=md-nav__item> <a href=#versions class=md-nav__link> Versions </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=../docker-mastodon/ class=md-nav__link> mastodon </a> </li> <li class=md-nav__item> <a href=../docker-medusa/ class=md-nav__link> medusa </a> </li> <li class=md-nav__item> <a href=../docker-minetest/ class=md-nav__link> minetest </a> </li> <li class=md-nav__item> <a href=../docker-minisatip/ class=md-nav__link> minisatip </a> </li> <li class=md-nav__item> <a href=../docker-mstream/ class=md-nav__link> mstream </a> </li> <li class=md-nav__item> <a href=../docker-mullvad-browser/ class=md-nav__link> mullvad-browser </a> </li> <li class=md-nav__item> <a href=../docker-muximux/ class=md-nav__link> muximux </a> </li> <li class=md-nav__item> <a href=../docker-mylar3/ class=md-nav__link> mylar3 </a> </li> <li class=md-nav__item> <a href=../docker-mysql-workbench/ class=md-nav__link> mysql-workbench </a> </li> <li class=md-nav__item> <a href=../docker-nano-discord-bot/ class=md-nav__link> nano-discord-bot </a> </li> <li class=md-nav__item> <a href=../docker-nano-wallet/ class=md-nav__link> nano-wallet </a> </li> <li class=md-nav__item> <a href=../docker-nano/ class=md-nav__link> nano </a> </li> <li class=md-nav__item> <a href=../docker-netbootxyz/ class=md-nav__link> netbootxyz </a> </li> <li class=md-nav__item> <a href=../docker-netbox/ class=md-nav__link> netbox </a> </li> <li class=md-nav__item> <a href=../docker-nextcloud/ class=md-nav__link> nextcloud </a> </li> <li class=md-nav__item> <a href=../docker-nginx/ class=md-nav__link> nginx </a> </li> <li class=md-nav__item> <a href=../docker-ngircd/ class=md-nav__link> ngircd </a> </li> <li class=md-nav__item> <a href=../docker-nntp2nntp/ class=md-nav__link> nntp2nntp </a> </li> <li class=md-nav__item> <a href=../docker-nzbget/ class=md-nav__link> nzbget </a> </li> <li class=md-nav__item> <a href=../docker-nzbhydra2/ class=md-nav__link> nzbhydra2 </a> </li> <li class=md-nav__item> <a href=../docker-ombi/ class=md-nav__link> ombi </a> </li> <li class=md-nav__item> <a href=../docker-openssh-server/ class=md-nav__link> openssh-server </a> </li> <li class=md-nav__item> <a href=../docker-openvpn-as/ class=md-nav__link> openvpn-as </a> </li> <li class=md-nav__item> <a href=../docker-openvscode-server/ class=md-nav__link> openvscode-server </a> </li> <li class=md-nav__item> <a href=../docker-opera/ class=md-nav__link> opera </a> </li> <li class=md-nav__item> <a href=../docker-organizr/ class=md-nav__link> organizr </a> </li> <li class=md-nav__item> <a href=../docker-oscam/ class=md-nav__link> oscam </a> </li> <li class=md-nav__item> <a href=../docker-overseerr/ class=md-nav__link> overseerr </a> </li> <li class=md-nav__item> <a href=../docker-pairdrop/ class=md-nav__link> pairdrop </a> </li> <li class=md-nav__item> <a href=../docker-paperless-ng/ class=md-nav__link> paperless-ng </a> </li> <li class=md-nav__item> <a href=../docker-paperless-ngx/ class=md-nav__link> paperless-ngx </a> </li> <li class=md-nav__item> <a href=../docker-papermerge/ class=md-nav__link> papermerge </a> </li> <li class=md-nav__item> <a href=../docker-photoshow/ class=md-nav__link> photoshow </a> </li> <li class=md-nav__item> <a href=../docker-phpmyadmin/ class=md-nav__link> phpmyadmin </a> </li> <li class=md-nav__item> <a href=../docker-pidgin/ class=md-nav__link> pidgin </a> </li> <li class=md-nav__item> <a href=../docker-piwigo/ class=md-nav__link> piwigo </a> </li> <li class=md-nav__item> <a href=../docker-pixapop/ class=md-nav__link> pixapop </a> </li> <li class=md-nav__item> <a href=../docker-plex-meta-manager/ class=md-nav__link> plex-meta-manager </a> </li> <li class=md-nav__item> <a href=../docker-plex/ class=md-nav__link> plex </a> </li> <li class=md-nav__item> <a href=../docker-projectsend/ class=md-nav__link> projectsend </a> </li> <li class=md-nav__item> <a href=../docker-prowlarr/ class=md-nav__link> prowlarr </a> </li> <li class=md-nav__item> <a href=../docker-pwndrop/ class=md-nav__link> pwndrop </a> </li> <li class=md-nav__item> <a href=../docker-pydio-cells/ class=md-nav__link> pydio-cells </a> </li> <li class=md-nav__item> <a href=../docker-pyload-ng/ class=md-nav__link> pyload-ng </a> </li> <li class=md-nav__item> <a href=../docker-pyload/ class=md-nav__link> pyload </a> </li> <li class=md-nav__item> <a href=../docker-pylon/ class=md-nav__link> pylon </a> </li> <li class=md-nav__item> <a href=../docker-qbittorrent/ class=md-nav__link> qbittorrent </a> </li> <li class=md-nav__item> <a href=../docker-qdirstat/ class=md-nav__link> qdirstat </a> </li> <li class=md-nav__item> <a href=../docker-quassel-core/ class=md-nav__link> quassel-core </a> </li> <li class=md-nav__item> <a href=../docker-quassel-web/ class=md-nav__link> quassel-web </a> </li> <li class=md-nav__item> <a href=../docker-radarr/ class=md-nav__link> radarr </a> </li> <li class=md-nav__item> <a href=../docker-raneto/ class=md-nav__link> raneto </a> </li> <li class=md-nav__item> <a href=../docker-rdesktop/ class=md-nav__link> rdesktop </a> </li> <li class=md-nav__item> <a href=../docker-readarr/ class=md-nav__link> readarr </a> </li> <li class=md-nav__item> <a href=../docker-remmina/ class=md-nav__link> remmina </a> </li> <li class=md-nav__item> <a href=../docker-requestrr/ class=md-nav__link> requestrr </a> </li> <li class=md-nav__item> <a href=../docker-resilio-sync/ class=md-nav__link> resilio-sync </a> </li> <li class=md-nav__item> <a href=../docker-rsnapshot/ class=md-nav__link> rsnapshot </a> </li> <li class=md-nav__item> <a href=../docker-sabnzbd/ class=md-nav__link> sabnzbd </a> </li> <li class=md-nav__item> <a href=../docker-scrutiny/ class=md-nav__link> scrutiny </a> </li> <li class=md-nav__item> <a href=../docker-shout-irc/ class=md-nav__link> shout-irc </a> </li> <li class=md-nav__item> <a href=../docker-sickchill/ class=md-nav__link> sickchill </a> </li> <li class=md-nav__item> <a href=../docker-sickgear/ class=md-nav__link> sickgear </a> </li> <li class=md-nav__item> <a href=../docker-smokeping/ class=md-nav__link> smokeping </a> </li> <li class=md-nav__item> <a href=../docker-snapdrop/ class=md-nav__link> snapdrop </a> </li> <li class=md-nav__item> <a href=../docker-snipe-it/ class=md-nav__link> snipe-it </a> </li> <li class=md-nav__item> <a href=../docker-sonarr/ class=md-nav__link> sonarr </a> </li> <li class=md-nav__item> <a href=../docker-sqlitebrowser/ class=md-nav__link> sqlitebrowser </a> </li> <li class=md-nav__item> <a href=../docker-swag/ class=md-nav__link> swag </a> </li> <li class=md-nav__item> <a href=../docker-synclounge/ class=md-nav__link> synclounge </a> </li> <li class=md-nav__item> <a href=../docker-syncthing/ class=md-nav__link> syncthing </a> </li> <li class=md-nav__item> <a href=../docker-syslog-ng/ class=md-nav__link> syslog-ng </a> </li> <li class=md-nav__item> <a href=../docker-taisun/ class=md-nav__link> taisun </a> </li> <li class=md-nav__item> <a href=../docker-tautulli/ class=md-nav__link> tautulli </a> </li> <li class=md-nav__item> <a href=../docker-thelounge/ class=md-nav__link> thelounge </a> </li> <li class=md-nav__item> <a href=../docker-transmission/ class=md-nav__link> transmission </a> </li> <li class=md-nav__item> <a href=../docker-tvheadend/ class=md-nav__link> tvheadend </a> </li> <li class=md-nav__item> <a href=../docker-ubooquity/ class=md-nav__link> ubooquity </a> </li> <li class=md-nav__item> <a href=../docker-unifi-controller/ class=md-nav__link> unifi-controller </a> </li> <li class=md-nav__item> <a href=../docker-vscodium/ class=md-nav__link> vscodium </a> </li> <li class=md-nav__item> <a href=../docker-webcord/ class=md-nav__link> webcord </a> </li> <li class=md-nav__item> <a href=../docker-webgrabplus/ class=md-nav__link> webgrabplus </a> </li> <li class=md-nav__item> <a href=../docker-webtop/ class=md-nav__link> webtop </a> </li> <li class=md-nav__item> <a href=../docker-wikijs/ class=md-nav__link> wikijs </a> </li> <li class=md-nav__item> <a href=../docker-wireguard/ class=md-nav__link> wireguard </a> </li> <li class=md-nav__item> <a href=../docker-wireshark/ class=md-nav__link> wireshark </a> </li> <li class=md-nav__item> <a href=../docker-wps-office/ class=md-nav__link> wps-office </a> </li> <li class=md-nav__item> <a href=../docker-xbackbone/ class=md-nav__link> xbackbone </a> </li> <li class=md-nav__item> <a href=../docker-your_spotify/ class=md-nav__link> your_spotify </a> </li> <li class=md-nav__item> <a href=../docker-yq/ class=md-nav__link> yq </a> </li> <li class=md-nav__item> <a href=../docker-znc/ class=md-nav__link> znc </a> </li> </ul> </nav> </li> <li class="md-nav__item md-nav__item--nested"> <input class="md-nav__toggle md-toggle " type=checkbox id=__nav_5> <label class=md-nav__link for=__nav_5 id=__nav_5_label tabindex=0> Misc <span class="md-nav__icon md-icon"></span> </label> <nav class=md-nav data-md-level=1 aria-labelledby=__nav_5_label aria-expanded=false> <label class=md-nav__title for=__nav_5> <span class="md-nav__icon md-icon"></span> Misc </label> <ul class=md-nav__list data-md-scrollfix> <li class=md-nav__item> <a href=../../misc/finances/ class=md-nav__link> Finances </a> </li> </ul> </nav> </li> </ul> </nav> </div> </div> </div> <div class="md-sidebar md-sidebar--secondary" data-md-component=sidebar data-md-type=toc> <div class=md-sidebar__scrollwrap> <div class=md-sidebar__inner> <nav class="md-nav md-nav--secondary" aria-label="Table of contents"> <label class=md-nav__title for=__toc> <span class="md-nav__icon md-icon"></span> Table of contents </label> <ul class=md-nav__list data-md-component=toc data-md-scrollfix> <li class=md-nav__item> <a href=#supported-architectures class=md-nav__link> Supported Architectures </a> </li> <li class=md-nav__item> <a href=#application-setup class=md-nav__link> Application Setup </a> <nav class=md-nav aria-label="Application Setup"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#loading-passwords-and-users-from-files class=md-nav__link> Loading passwords and users from files </a> </li> <li class=md-nav__item> <a href=#bootstrapping-a-new-instance class=md-nav__link> Bootstrapping a new instance </a> </li> <li class=md-nav__item> <a href=#check-and-repair class=md-nav__link> Check and Repair </a> </li> <li class=md-nav__item> <a href=#upgrading class=md-nav__link> Upgrading </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#usage class=md-nav__link> Usage </a> <nav class=md-nav aria-label=Usage> <ul class=md-nav__list> <li class=md-nav__item> <a href=#docker-compose-recommended-click-here-for-more-info class=md-nav__link> docker-compose (recommended, click here for more info) </a> </li> <li class=md-nav__item> <a href=#docker-cli-click-here-for-more-info class=md-nav__link> docker cli (click here for more info) </a> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#parameters class=md-nav__link> Parameters </a> <nav class=md-nav aria-label=Parameters> <ul class=md-nav__list> <li class=md-nav__item> <a href=#ports-p class=md-nav__link> Ports (-p) </a> </li> <li class=md-nav__item> <a href=#environment-variables-e class=md-nav__link> Environment Variables (-e) </a> </li> <li class=md-nav__item> <a href=#volume-mappings-v class=md-nav__link> Volume Mappings (-v) </a> <nav class=md-nav aria-label="Volume Mappings (-v)"> <ul class=md-nav__list> <li class=md-nav__item> <a href=#miscellaneous-options class=md-nav__link> Miscellaneous Options </a> </li> </ul> </nav> </li> </ul> </nav> </li> <li class=md-nav__item> <a href=#environment-variables-from-files-docker-secrets class=md-nav__link> Environment variables from files (Docker secrets) </a> </li> <li class=md-nav__item> <a href=#umask-for-running-applications class=md-nav__link> Umask for running applications </a> </li> <li class=md-nav__item> <a href=#user-group-identifiers class=md-nav__link> User / Group Identifiers </a> </li> <li class=md-nav__item> <a href=#docker-mods class=md-nav__link> Docker Mods </a> </li> <li class=md-nav__item> <a href=#support-info class=md-nav__link> Support Info </a> </li> <li class=md-nav__item> <a href=#versions class=md-nav__link> Versions </a> </li> </ul> </nav> </div> </div> </div> <div class=md-content data-md-component=content> <article class="md-content__inner md-typeset"> <!-- DO NOT EDIT THIS FILE MANUALLY  --> <!-- Please read the https://github.com/linuxserver/docker-mariadb/blob/master/.github/CONTRIBUTING.md --> <h1 id=linuxservermariadb><a href=https://github.com/linuxserver/docker-mariadb>linuxserver/mariadb</a></h1> <p><a href=https://scarf.sh/gateway/linuxserver-ci/docker/linuxserver%2Fmariadb><img alt="Scarf.io pulls" src="https://scarf.sh/installs-badge/linuxserver-ci/linuxserver%2Fmariadb?color=94398d&label-color=555555&logo-color=ffffff&style=for-the-badge&package-type=docker"></a> <a href=https://github.com/linuxserver/docker-mariadb><img alt="GitHub Stars" src="https://img.shields.io/github/stars/linuxserver/docker-mariadb.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&logo=github"></a> <a href=https://github.com/linuxserver/docker-mariadb/releases><img alt="GitHub Release" src="https://img.shields.io/github/release/linuxserver/docker-mariadb.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&logo=github"></a> <a href=https://github.com/linuxserver/docker-mariadb/packages><img alt="GitHub Package Repository" src="https://img.shields.io/static/v1.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=linuxserver.io&message=GitHub%20Package&logo=github"></a> <a href=https://gitlab.com/linuxserver.io/docker-mariadb/container_registry><img alt="GitLab Container Registry" src="https://img.shields.io/static/v1.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=linuxserver.io&message=GitLab%20Registry&logo=gitlab"></a> <a href=https://quay.io/repository/linuxserver.io/mariadb><img alt=Quay.io src="https://img.shields.io/static/v1.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=linuxserver.io&message=Quay.io"></a> <a href=https://hub.docker.com/r/linuxserver/mariadb><img alt="Docker Pulls" src="https://img.shields.io/docker/pulls/linuxserver/mariadb.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=pulls&logo=docker"></a> <a href=https://hub.docker.com/r/linuxserver/mariadb><img alt="Docker Stars" src="https://img.shields.io/docker/stars/linuxserver/mariadb.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=stars&logo=docker"></a> <a href=https://ci.linuxserver.io/job/Docker-Pipeline-Builders/job/docker-mariadb/job/master/ ><img alt="Jenkins Build" src="https://img.shields.io/jenkins/build?labelColor=555555&logoColor=ffffff&style=for-the-badge&jobUrl=https%3A%2F%2Fci.linuxserver.io%2Fjob%2FDocker-Pipeline-Builders%2Fjob%2Fdocker-mariadb%2Fjob%2Fmaster%2F&logo=jenkins"></a> <a href=https://ci-tests.linuxserver.io/linuxserver/mariadb/latest/index.html><img alt="LSIO CI" src="https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=CI&query=CI&url=https%3A%2F%2Fci-tests.linuxserver.io%2Flinuxserver%2Fmariadb%2Flatest%2Fci-status.yml"></a></p> <p><a href=https://mariadb.org/ >Mariadb</a> is one of the most popular database servers. Made by the original developers of MySQL.</p> <h2 id=supported-architectures>Supported Architectures</h2> <p>We utilise the docker manifest for multi-platform awareness. More information is available from docker <a href=https://github.com/docker/distribution/blob/master/docs/spec/manifest-v2-2.md#manifest-list>here</a> and our announcement <a href=https://blog.linuxserver.io/2019/02/21/the-lsio-pipeline-project/ >here</a>.</p> <p>Simply pulling <code>lscr.io/linuxserver/mariadb:latest</code> should retrieve the correct image for your arch, but you can also pull specific arch images via tags.</p> <p>The architectures supported by this image are:</p> <table> <thead> <tr> <th align=center>Architecture</th> <th align=center>Available</th> <th>Tag</th> </tr> </thead> <tbody> <tr> <td align=center>x86-64</td> <td align=center>✅</td> <td>amd64-\&lt;version tag></td> </tr> <tr> <td align=center>arm64</td> <td align=center>✅</td> <td>arm64v8-\&lt;version tag></td> </tr> <tr> <td align=center>armhf</td> <td align=center>❌</td> <td></td> </tr> </tbody> </table> <h2 id=application-setup>Application Setup</h2> <p>If you didn't set a password during installation, (see logs for warning) use <code>mariadb-admin -u root -p&lt;PASSWORD&gt;</code> to set one at the docker prompt...</p> <p>NOTE changing the MYSQL_ROOT_PASSWORD variable after the container has set up the initial databases has no effect, use the mysqladmin tool to change your mariadb password.</p> <p>NOTE if you want to use (MYSQL_DATABASE MYSQL_USER MYSQL_PASSWORD) <strong>all three</strong> of these variables need to be set you cannot pick and choose.</p> <p>Unraid users, it is advisable to edit the template/webui after setup and remove reference to this variable.</p> <p>Find custom.cnf in /config for config changes (restart container for them to take effect) , the databases in /config/databases and the log in /config/log/myqsl</p> <h3 id=loading-passwords-and-users-from-files>Loading passwords and users from files</h3> <p>The <code>MYSQL_ROOT_PASSWORD MYSQL_DATABASE MYSQL_USER MYSQL_PASSWORD REMOTE_SQL</code> env values can be set in a file:</p> <div class=highlight><pre><span></span><code>/config/env
</code></pre></div> <p>Using the following format:</p> <div class=highlight><pre><span></span><code>MYSQL_ROOT_PASSWORD=&quot;ROOT_ACCESS_PASSWORD&quot;
MYSQL_DATABASE=&quot;USER_DB_NAME&quot;
MYSQL_USER=&quot;MYSQL_USER&quot;
MYSQL_PASSWORD=&quot;DATABASE_PASSWORD&quot;
REMOTE_SQL=&quot;http://URL1/your.sql,https://URL2/your.sql&quot;
</code></pre></div> <p>These settings can be mixed and matched with Docker ENV settings as you require, but the settings in the file will always take precedence.</p> <h3 id=bootstrapping-a-new-instance>Bootstrapping a new instance</h3> <p>We support a one time run of custom sql files on init. In order to use this place <code>*.sql</code> files in:</p> <p><div class=highlight><pre><span></span><code>/config/initdb.d/
</code></pre></div> This will have the same effect as setting the <code>REMOTE_SQL</code> environment variable. The sql will only be run on the containers first boot and setup.</p> <h3 id=check-and-repair>Check and Repair</h3> <p>If user databases are not in a healthy state (sometimes caused by a failed upgrade), it may be remedied by running:</p> <div class=highlight><pre><span></span><code>mariadb-check<span class=w> </span>-u<span class=w> </span>root<span class=w> </span>-p&lt;PASSWORD&gt;<span class=w> </span>-c<span class=w> </span>-A<span class=w> </span><span class=c1># check all databases for errors</span>
mariadb-check<span class=w> </span>-u<span class=w> </span>root<span class=w> </span>-p&lt;PASSWORD&gt;<span class=w> </span>-r<span class=w> </span>-A<span class=w> </span><span class=c1># repair all databases</span>
mariadb-check<span class=w> </span>-u<span class=w> </span>root<span class=w> </span>-p&lt;PASSWORD&gt;<span class=w> </span>-a<span class=w> </span>-A<span class=w> </span><span class=c1># analyze all databases</span>
mariadb-check<span class=w> </span>-u<span class=w> </span>root<span class=w> </span>-p&lt;PASSWORD&gt;<span class=w> </span>-o<span class=w> </span>-A<span class=w> </span><span class=c1># optimize all databases</span>
</code></pre></div> <p>After running the above commands, you may need to run the upgrade command again.</p> <h3 id=upgrading>Upgrading</h3> <p>When this container initializes, if <code>MYSQL_ROOT_PASSWORD</code> is set an upgrade check will run. If an upgrade is required the log will indicate the need stop any services that are accessing databases in this container, and then run the command:</p> <div class=highlight><pre><span></span><code>mariadb-upgrade<span class=w> </span>-u<span class=w> </span>root<span class=w> </span>-p&lt;PASSWORD&gt;
</code></pre></div> <h2 id=usage>Usage</h2> <p>To help you get started creating a container from this image you can either use docker-compose or the docker cli.</p> <h3 id=docker-compose-recommended-click-here-for-more-info>docker-compose (recommended, <a href=https://docs.linuxserver.io/general/docker-compose>click here for more info</a>)</h3> <div class=highlight><pre><span></span><code><span class=nn>---</span>
<span class=nt>version</span><span class=p>:</span><span class=w> </span><span class=s>&quot;2.1&quot;</span>
<span class=nt>services</span><span class=p>:</span>
<span class=w>  </span><span class=nt>mariadb</span><span class=p>:</span>
<span class=w>    </span><span class=nt>image</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">lscr.io/linuxserver/mariadb:latest</span>
<span class=w>    </span><span class=nt>container_name</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">mariadb</span>
<span class=w>    </span><span class=nt>environment</span><span class=p>:</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">PUID=1000</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">PGID=1000</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">TZ=Etc/UTC</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">MYSQL_ROOT_PASSWORD=ROOT_ACCESS_PASSWORD</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">MYSQL_DATABASE=USER_DB_NAME</span><span class=w> </span><span class=c1>#optional</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">MYSQL_USER=MYSQL_USER</span><span class=w> </span><span class=c1>#optional</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">MYSQL_PASSWORD=DATABASE_PASSWORD</span><span class=w> </span><span class=c1>#optional</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">REMOTE_SQL=http://URL1/your.sql,https://URL2/your.sql</span><span class=w> </span><span class=c1>#optional</span>
<span class=w>    </span><span class=nt>volumes</span><span class=p>:</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">path_to_data:/config</span>
<span class=w>    </span><span class=nt>ports</span><span class=p>:</span>
<span class=w>      </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">3306:3306</span>
<span class=w>    </span><span class=nt>restart</span><span class=p>:</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">unless-stopped</span>
</code></pre></div> <h3 id=docker-cli-click-here-for-more-info>docker cli (<a href=https://docs.docker.com/engine/reference/commandline/cli/ >click here for more info</a>)</h3> <div class=highlight><pre><span></span><code>docker<span class=w> </span>run<span class=w> </span>-d<span class=w> </span><span class=se>\</span>
<span class=w>  </span>--name<span class=o>=</span>mariadb<span class=w> </span><span class=se>\</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>PUID</span><span class=o>=</span><span class=m>1000</span><span class=w> </span><span class=se>\</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>PGID</span><span class=o>=</span><span class=m>1000</span><span class=w> </span><span class=se>\</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>TZ</span><span class=o>=</span>Etc/UTC<span class=w> </span><span class=se>\</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>MYSQL_ROOT_PASSWORD</span><span class=o>=</span>ROOT_ACCESS_PASSWORD<span class=w> </span><span class=se>\</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>MYSQL_DATABASE</span><span class=o>=</span>USER_DB_NAME<span class=w> </span><span class=sb>`</span><span class=c1>#optional` \</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>MYSQL_USER</span><span class=o>=</span>MYSQL_USER<span class=w> </span><span class=sb>`</span><span class=c1>#optional` \</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>MYSQL_PASSWORD</span><span class=o>=</span>DATABASE_PASSWORD<span class=w> </span><span class=sb>`</span><span class=c1>#optional` \</span>
<span class=w>  </span>-e<span class=w> </span><span class=nv>REMOTE_SQL</span><span class=o>=</span>http://URL1/your.sql,https://URL2/your.sql<span class=w> </span><span class=sb>`</span><span class=c1>#optional` \</span>
<span class=w>  </span>-p<span class=w> </span><span class=m>3306</span>:3306<span class=w> </span><span class=se>\</span>
<span class=w>  </span>-v<span class=w> </span>path_to_data:/config<span class=w> </span><span class=se>\</span>
<span class=w>  </span>--restart<span class=w> </span>unless-stopped<span class=w> </span><span class=se>\</span>
<span class=w>  </span>lscr.io/linuxserver/mariadb:latest
</code></pre></div> <h2 id=parameters>Parameters</h2> <p>Docker images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate <code>&lt;external&gt;:&lt;internal&gt;</code> respectively. For example, <code>-p 8080:80</code> would expose port <code>80</code> from inside the container to be accessible from the host's IP on port <code>8080</code> outside the container.</p> <h3 id=ports-p>Ports (<code>-p</code>)</h3> <table> <thead> <tr> <th align=center>Parameter</th> <th>Function</th> </tr> </thead> <tbody> <tr> <td align=center><code>3306</code></td> <td>Mariadb listens on this port.</td> </tr> </tbody> </table> <h3 id=environment-variables-e>Environment Variables (<code>-e</code>)</h3> <table> <thead> <tr> <th align=center>Env</th> <th>Function</th> </tr> </thead> <tbody> <tr> <td align=center><code>PUID=1000</code></td> <td>for UserID - see below for explanation</td> </tr> <tr> <td align=center><code>PGID=1000</code></td> <td>for GroupID - see below for explanation</td> </tr> <tr> <td align=center><code>TZ=Etc/UTC</code></td> <td>specify a timezone to use, see this <a href=https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List>list</a>.</td> </tr> <tr> <td align=center><code>MYSQL_ROOT_PASSWORD=ROOT_ACCESS_PASSWORD</code></td> <td>Set this to root password for installation (minimum 4 characters &amp; non-alphanumeric passwords must be properly escaped).</td> </tr> <tr> <td align=center><code>MYSQL_DATABASE=USER_DB_NAME</code></td> <td>Specify the name of a database to be created on image startup.</td> </tr> <tr> <td align=center><code>MYSQL_USER=MYSQL_USER</code></td> <td>This user will have superuser access to the database specified by MYSQL_DATABASE (do not use root here).</td> </tr> <tr> <td align=center><code>MYSQL_PASSWORD=DATABASE_PASSWORD</code></td> <td>Set this to the password you want to use for you MYSQL_USER (minimum 4 characters &amp; non-alphanumeric passwords must be properly escaped).</td> </tr> <tr> <td align=center><code>REMOTE_SQL=http://URL1/your.sql,https://URL2/your.sql</code></td> <td>Set this to ingest sql files from an http/https endpoint (comma seperated array).</td> </tr> </tbody> </table> <h3 id=volume-mappings-v>Volume Mappings (<code>-v</code>)</h3> <table> <thead> <tr> <th align=center>Volume</th> <th>Function</th> </tr> </thead> <tbody> <tr> <td align=center><code>/config</code></td> <td>Contains the db itself and all assorted settings.</td> </tr> </tbody> </table> <h4 id=miscellaneous-options>Miscellaneous Options</h4> <table> <thead> <tr> <th align=center>Parameter</th> <th>Function</th> </tr> </thead> <tbody> <tr> <td></td> <td></td> </tr> </tbody> </table> <h2 id=environment-variables-from-files-docker-secrets>Environment variables from files (Docker secrets)</h2> <p>You can set any environment variable from a file by using a special prepend <code>FILE__</code>.</p> <p>As an example:</p> <div class=highlight><pre><span></span><code>-e<span class=w> </span><span class=nv>FILE__PASSWORD</span><span class=o>=</span>/run/secrets/mysecretpassword
</code></pre></div> <p>Will set the environment variable <code>PASSWORD</code> based on the contents of the <code>/run/secrets/mysecretpassword</code> file.</p> <h2 id=umask-for-running-applications>Umask for running applications</h2> <p>For all of our images we provide the ability to override the default umask settings for services started within the containers using the optional <code>-e UMASK=022</code> setting. Keep in mind umask is not chmod it subtracts from permissions based on it's value it does not add. Please read up <a href=https://en.wikipedia.org/wiki/Umask>here</a> before asking for support.</p> <h2 id=user-group-identifiers>User / Group Identifiers</h2> <p>When using volumes (<code>-v</code> flags), permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user <code>PUID</code> and group <code>PGID</code>.</p> <p>Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.</p> <p>In this instance <code>PUID=1000</code> and <code>PGID=1000</code>, to find yours use <code>id user</code> as below:</p> <div class=highlight><pre><span></span><code><span class=w>  </span>$<span class=w> </span>id<span class=w> </span>username
<span class=w>    </span><span class=nv>uid</span><span class=o>=</span><span class=m>1000</span><span class=o>(</span>dockeruser<span class=o>)</span><span class=w> </span><span class=nv>gid</span><span class=o>=</span><span class=m>1000</span><span class=o>(</span>dockergroup<span class=o>)</span><span class=w> </span><span class=nv>groups</span><span class=o>=</span><span class=m>1000</span><span class=o>(</span>dockergroup<span class=o>)</span>
</code></pre></div> <h2 id=docker-mods>Docker Mods</h2> <p><a href="https://mods.linuxserver.io/?mod=mariadb" title="view available mods for this container."><img alt="Docker Mods" src="https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=mariadb&query=%24.mods%5B%27mariadb%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml"></a> <a href="https://mods.linuxserver.io/?mod=universal" title="view available universal mods."><img alt="Docker Universal Mods" src="https://img.shields.io/badge/dynamic/yaml?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=universal&query=%24.mods%5B%27universal%27%5D.mod_count&url=https%3A%2F%2Fraw.githubusercontent.com%2Flinuxserver%2Fdocker-mods%2Fmaster%2Fmod-list.yml"></a></p> <p>We publish various <a href=https://github.com/linuxserver/docker-mods>Docker Mods</a> to enable additional functionality within the containers. The list of Mods available for this image (if any) as well as universal mods that can be applied to any one of our images can be accessed via the dynamic badges above.</p> <h2 id=support-info>Support Info</h2> <ul> <li>Shell access whilst the container is running:</li> <li><code>docker exec -it mariadb /bin/bash</code></li> <li>To monitor the logs of the container in realtime:</li> <li><code>docker logs -f mariadb</code></li> <li>Container version number</li> <li><code>docker inspect -f '{{ index .Config.Labels "build_version" }}' mariadb</code></li> <li>Image version number</li> <li><code>docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/mariadb:latest</code></li> </ul> <h2 id=versions>Versions</h2> <ul> <li><strong>09.06.23:</strong> - Update lc_messages path in shipped custom.cnf to match upstream.</li> <li><strong>25.05.23:</strong> - Rebase to Alpine 3.18, deprecate armhf.</li> <li><strong>04.02.23:</strong> - Minor updates to defaults in custom.cnf.</li> <li><strong>31.01.23:</strong> - Rebase to 3.17.</li> <li><strong>09.12.22:</strong> - Add upgrade check warning.</li> <li><strong>11.10.22:</strong> - Rebase master to Alpine 3.16, migrate to s6v3, remove password escape logic which caused problems for a small subset of users.</li> <li><strong>06.07.21:</strong> - Rebase master to alpine.</li> <li><strong>03.07.21:</strong> - Rebase to 3.14.</li> <li><strong>08.02.21:</strong> - Fix new installs.</li> <li><strong>08.02.21:</strong> - Rebase to alpine. Add mariadb-backup.</li> <li><strong>08.02.21:</strong> - Release alpine tag. The alpine release will replace the latest tag in the near future.</li> <li><strong>27.10.19:</strong> - Bump to 10.4, ability use custom sql on initial init ,defining root passwords via file.</li> <li><strong>23.03.19:</strong> - Switching to new Base images, shift to arm32v7 tag.</li> <li><strong>07.03.19:</strong> - Add ability to setup a database and default user on first spinup.</li> <li><strong>26.01.19:</strong> - Add pipeline logic and multi arch.</li> <li><strong>10.09.18:</strong> - Rebase to ubuntu bionic and use 10.3 mariadb repository.</li> <li><strong>09.12.17:</strong> - Fix continuation lines.</li> <li><strong>12.09.17:</strong> - Gracefully shut down mariadb.</li> <li><strong>27.10.16:</strong> - Implement linting suggestions on database init script.</li> <li><strong>11.10.16:</strong> - Rebase to ubuntu xenial, add version labelling.</li> <li><strong>09.03.16:</strong> - Update to mariadb 10.1. Change to use custom.cnf over my.cnf in /config. Restructured init files to change config options on startup, rather than in the dockerfile.</li> <li><strong>26.01.16:</strong> - Change user of mysqld_safe script to abc, better unclean shutdown handling on restart.</li> <li><strong>23.12.15:</strong> - Remove autoupdating, between some version updates the container breaks.</li> <li><strong>12.08.15:</strong> - Initial Release.</li> </ul> </article> </div> </div> </main> <footer class=md-footer> <div class="md-footer-meta md-typeset"> <div class="md-footer-meta__inner md-grid"> <div class=md-copyright> <div class=md-copyright__highlight> Copyright &copy; 2022 LinuxServer.io </div> Made with <a href=https://squidfunk.github.io/mkdocs-material/ target=_blank rel=noopener> Material for MkDocs </a> </div> <div class=md-social> <a href=https://github.com/linuxserver target=_blank rel=noopener title=github.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M400 32H48C21.5 32 0 53.5 0 80v352c0 26.5 21.5 48 48 48h352c26.5 0 48-21.5 48-48V80c0-26.5-21.5-48-48-48zM277.3 415.7c-8.4 1.5-11.5-3.7-11.5-8 0-5.4.2-33 .2-55.3 0-15.6-5.2-25.5-11.3-30.7 37-4.1 76-9.2 76-73.1 0-18.2-6.5-27.3-17.1-39 1.7-4.3 7.4-22-1.7-45-13.9-4.3-45.7 17.9-45.7 17.9-13.2-3.7-27.5-5.6-41.6-5.6-14.1 0-28.4 1.9-41.6 5.6 0 0-31.8-22.2-45.7-17.9-9.1 22.9-3.5 40.6-1.7 45-10.6 11.7-15.6 20.8-15.6 39 0 63.6 37.3 69 74.3 73.1-4.8 4.3-9.1 11.7-10.6 22.3-9.5 4.3-33.8 11.7-48.3-13.9-9.1-15.8-25.5-17.1-25.5-17.1-16.2-.2-1.1 10.2-1.1 10.2 10.8 5 18.4 24.2 18.4 24.2 9.7 29.7 56.1 19.7 56.1 19.7 0 13.9.2 36.5.2 40.6 0 4.3-3 9.5-11.5 8-66-22.1-112.2-84.9-112.2-158.3 0-91.8 70.2-161.5 162-161.5S388 165.6 388 257.4c.1 73.4-44.7 136.3-110.7 158.3zm-98.1-61.1c-1.9.4-3.7-.4-3.9-1.7-.2-1.5 1.1-2.8 3-3.2 1.9-.2 3.7.6 3.9 1.9.3 1.3-1 2.6-3 3zm-9.5-.9c0 1.3-1.5 2.4-3.5 2.4-2.2.2-3.7-.9-3.7-2.4 0-1.3 1.5-2.4 3.5-2.4 1.9-.2 3.7.9 3.7 2.4zm-13.7-1.1c-.4 1.3-2.4 1.9-4.1 1.3-1.9-.4-3.2-1.9-2.8-3.2.4-1.3 2.4-1.9 4.1-1.5 2 .6 3.3 2.1 2.8 3.4zm-12.3-5.4c-.9 1.1-2.8.9-4.3-.6-1.5-1.3-1.9-3.2-.9-4.1.9-1.1 2.8-.9 4.3.6 1.3 1.3 1.8 3.3.9 4.1zm-9.1-9.1c-.9.6-2.6 0-3.7-1.5s-1.1-3.2 0-3.9c1.1-.9 2.8-.2 3.7 1.3 1.1 1.5 1.1 3.3 0 4.1zm-6.5-9.7c-.9.9-2.4.4-3.5-.6-1.1-1.3-1.3-2.8-.4-3.5.9-.9 2.4-.4 3.5.6 1.1 1.3 1.3 2.8.4 3.5zm-6.7-7.4c-.4.9-1.7 1.1-2.8.4-1.3-.6-1.9-1.7-1.5-2.6.4-.6 1.5-.9 2.8-.4 1.3.7 1.9 1.8 1.5 2.6z"/></svg> </a> <a href=https://gitlab.com/linuxserver.io target=_blank rel=noopener title=gitlab.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M48 32h352c26.5 0 48 21.5 48 48v352c0 26.5-21.5 48-48 48H48c-26.5 0-48-21.5-48-48V80c0-26.5 21.5-48 48-48zm334.1 192.9-44.6-116.4c-.9-2.3-2.6-4.3-4.6-5.6-1.6-1-3.4-1.6-5.2-1.8-1.8-.2-3.7.1-5.4.7-1.7.7-3.3 1.7-4.5 3.1-1.2 1.4-2.1 3-2.6 4.8L285 201.9H162.1l-29.2-92.2c-.5-1.8-1.5-3.4-2.7-4.8-2.1-1.3-2.8-2.4-4.5-3-2.6-.7-3.6-1.8-5.4-.8-1.8.2-3.6.8-5.2 1.8-2 1.3-3.6 3.3-4.5 5.6L65.94 224.9l-.47 1.2a82.94 82.94 0 0 0-2.25 52.5c4.96 17.3 15.4 32.5 29.75 43.3l.17.1.38.3 67.88 50.9 54.2 40.9c1.5 1 5.3 2.8 8.3 2.8 3 0 6-1.8 8.4-2.8l54.1-40.9 68.4-51.2.2-.1c14.4-10.9 24.8-26.1 29.8-43.3 4.9-17.3 3.3-35.7-2.3-52.5l-.4-1.2z"/></svg> </a> <a href=https://twitter.com/linuxserverio target=_blank rel=noopener title=twitter.com class=md-social__link> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 448 512"><!-- Font Awesome Free 6.4.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M400 32H48C21.5 32 0 53.5 0 80v352c0 26.5 21.5 48 48 48h352c26.5 0 48-21.5 48-48V80c0-26.5-21.5-48-48-48zm-48.9 158.8c.2 2.8.2 5.7.2 8.5 0 86.7-66 186.6-186.6 186.6-37.2 0-71.7-10.8-100.7-29.4 5.3.6 10.4.8 15.8.8 30.7 0 58.9-10.4 81.4-28-28.8-.6-53-19.5-61.3-45.5 10.1 1.5 19.2 1.5 29.6-1.2-30-6.1-52.5-32.5-52.5-64.4v-.8c8.7 4.9 18.9 7.9 29.6 8.3a65.447 65.447 0 0 1-29.2-54.6c0-12.2 3.2-23.4 8.9-33.1 32.3 39.8 80.8 65.8 135.2 68.6-9.3-44.5 24-80.6 64-80.6 18.9 0 35.9 7.9 47.9 20.7 14.8-2.8 29-8.3 41.6-15.8-4.9 15.2-15.2 28-28.8 36.1 13.2-1.4 26-5.1 37.8-10.2-8.9 13.1-20.1 24.7-32.9 34z"/></svg> </a> </div> </div> </div> </footer> </div> <div class=md-dialog data-md-component=dialog> <div class="md-dialog__inner md-typeset"></div> </div> <script id=__config type=application/json>{"base": "../..", "features": ["navigation.instant"], "search": "../../assets/javascripts/workers/search.208ed371.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script> <script src=../../assets/javascripts/bundle.a51614de.min.js></script> </body> </html>