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

69 wiersze
103 KiB
HTML
Czysty Zwykły widok Historia

<!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-manyfold/ rel=prev><link href=../docker-mastodon/ rel=next><link rel=icon href=../../assets/favicon.ico><meta name=generator content="mkdocs-1.6.1, mkdocs-material-9.5.34"><title>mariadb - LinuxServer.io</title><link rel=stylesheet href=../../assets/stylesheets/main.35f28582.min.css><link rel=stylesheet href=../../assets/stylesheets/palette.06af60db.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> <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 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=../../assets/icon.svg 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 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></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_0> <label class="md-header__button md-icon" title="Switch to dark mode" for=__palette_1 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></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_1> <label class="md-header__button md-icon" title="Switch to light mode" for=__palette_0 hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg> </label> </form> <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md
</span></code></pre></div> <p>Using the following format:</p> <div class="language-text highlight"><pre><span></span><code><span id=__span-1-1><a id=__codelineno-1-1 name=__codelineno-1-1 href=#__codelineno-1-1></a>MYSQL_ROOT_PASSWORD=&quot;ROOT_ACCESS_PASSWORD&quot;
</span><span id=__span-1-2><a id=__codelineno-1-2 name=__codelineno-1-2 href=#__codelineno-1-2></a>MYSQL_DATABASE=&quot;USER_DB_NAME&quot;
</span><span id=__span-1-3><a id=__codelineno-1-3 name=__codelineno-1-3 href=#__codelineno-1-3></a>MYSQL_USER=&quot;MYSQL_USER&quot;
</span><span id=__span-1-4><a id=__codelineno-1-4 name=__codelineno-1-4 href=#__codelineno-1-4></a>MYSQL_PASSWORD=&quot;DATABASE_PASSWORD&quot;
</span><span id=__span-1-5><a id=__codelineno-1-5 name=__codelineno-1-5 href=#__codelineno-1-5></a>REMOTE_SQL=&quot;http://URL1/your.sql,https://URL2/your.sql&quot;
</span></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<a class=headerlink href=#bootstrapping-a-new-instance title="Permanent link">&para;</a></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="language-text highlight"><pre><span></span><code><span id=__span-2-1><a id=__codelineno-2-1 name=__codelineno-2-1 href=#__codelineno-2-1></a>/config/initdb.d/
</span></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<a class=headerlink href=#check-and-repair title="Permanent link">&para;</a></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="language-shell highlight"><pre><span></span><code><span id=__span-3-1><a id=__codelineno-3-1 name=__codelineno-3-1 href=#__codelineno-3-1></a>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>
</span><span id=__span-3-2><a id=__codelineno-3-2 name=__codelineno-3-2 href=#__codelineno-3-2></a>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>
</span><span id=__span-3-3><a id=__codelineno-3-3 name=__codelineno-3-3 href=#__codelineno-3-3></a>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>
</span><span id=__span-3-4><a id=__codelineno-3-4 name=__codelineno-3-4 href=#__codelineno-3-4></a>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>
</span></code></pre></div> <p>After running the above commands, you may need to run the upgrade command again.</p> <h3 id=upgrading>Upgrading<a class=headerlink href=#upgrading title="Permanent link">&para;</a></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="language-shell highlight"><pre><span></span><code><span id=__span-4-1><a id=__codelineno-4-1 name=__codelineno-4-1 href=#__codelineno-4-1></a>mariadb-upgrade<span class=w> </span>-u<span class=w> </span>root<span class=w> </span>-p&lt;PASSWORD&gt;
</span></code></pre></div> <h2 id=usage>Usage<a class=headerlink href=#usage title="Permanent link">&para;</a></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>)<a class=headerlink href=#docker-compose-recommended-click-here-for-more-info title="Permanent link">&para;</a></h3> <div class="language-yaml highlight"><pre><span></span><code><span id=__span-5-1><a id=__codelineno-5-1 name=__codelineno-5-1 href=#__codelineno-5-1></a><span class=nn>---</span>
</span><span id=__span-5-2><a id=__codelineno-5-2 name=__codelineno-5-2 href=#__codelineno-5-2></a><span class=nt>services</span><span class=p>:</span>
</span><span id=__span-5-3><a id=__codelineno-5-3 name=__codelineno-5-3 href=#__codelineno-5-3></a><span class=w> </span><span class=nt>mariadb</span><span class=p>:</span>
</span><span id=__span-5-4><a id=__codelineno-5-4 name=__codelineno-5-4 href=#__codelineno-5-4></a><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><span id=__span-5-5><a id=__codelineno-5-5 name=__codelineno-5-5 href=#__codelineno-5-5></a><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><span id=__span-5-6><a id=__codelineno-5-6 name=__codelineno-5-6 href=#__codelineno-5-6></a><span class=w> </span><span class=nt>environment</span><span class=p>:</span>
</span><span id=__span-5-7><a id=__codelineno-5-7 name=__codelineno-5-7 href=#__codelineno-5-7></a><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><span id=__span-5-8><a id=__codelineno-5-8 name=__codelineno-5-8 href=#__codelineno-5-8></a><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><span id=__span-5-9><a id=__codelineno-5-9 name=__codelineno-5-9 href=#__codelineno-5-9></a><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><span id=__span-5-10><a id=__codelineno-5-10 name=__codelineno-5-10 href=#__codelineno-5-10></a><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><span id=__span-5-11><a id=__codelineno-5-11 name=__codelineno-5-11 href=#__codelineno-5-11></a><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><span id=__span-5-12><a id=__codelineno-5-12 name=__codelineno-5-12 href=#__codelineno-5-12></a><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><span id=__span-5-13><a id=__codelineno-5-13 name=__codelineno-5-13 href=#__codelineno-5-13></a><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><span id=__span-5-14><a id=__codelineno-5-14 name=__codelineno-5-14 href=#__codelineno-5-14></a><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><span id=__span-5-15><a id=__codelineno-5-15 name=__codelineno-5-15 href=#__codelineno-5-15></a><span class=w> </span><span class=nt>volumes</span><span class=p>:</span>
</span><span id=__span-5-16><a id=__codelineno-5-16 name=__codelineno-5-16 href=#__codelineno-5-16></a><span class=w> </span><span class="p p-Indicator">-</span><span class=w> </span><span class="l l-Scalar l-Scalar-Plain">/path/to/mariadb/config:/config</span>
</span><span id=__span-5-17><a id=__codelineno-5-17 name=__codelineno-5-17 href=#__codelineno-5-17></a><span class=w> </span><span class=nt>ports</span><span class=p>:</span>
</span><span id=__span-5-18><a id=__codelineno-5-18 name=__codelineno-5-18 href=#__codelineno-5-18></a><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><span id=__span-5-19><a id=__codelineno-5-19 name=__codelineno-5-19 href=#__codelineno-5-19></a><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>
</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>)<a class=headerlink href=#docker-cli-click-here-for-more-info title="Permanent link">&para;</a></h3> <div class="language-bash highlight"><pre><span></span><code><span id=__span-6-1><a id=__codelineno-6-1 name=__codelineno-6-1 href=#__codelineno-6-1></a>docker<span class=w> </span>run<span class=w> </span>-d<span class=w> </span><span class=se>\</span>
</span><span id=__span-6-2><a id=__codelineno-6-2 name=__codelineno-6-2 href=#__codelineno-6-2></a><span class=w> </span>--name<span class=o>=</span>mariadb<span class=w> </span><span class=se>\</span>
</span><span id=__span-6-3><a id=__codelineno-6-3 name=__codelineno-6-3 href=#__codelineno-6-3></a><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><span id=__span-6-4><a id=__codelineno-6-4 name=__codelineno-6-4 href=#__codelineno-6-4></a><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><span id=__span-6-5><a id=__codelineno-6-5 name=__codelineno-6-5 href=#__codelineno-6-5></a><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><span id=__span-6-6><a id=__codelineno-6-6 name=__codelineno-6-6 href=#__codelineno-6-6></a><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><span id=__span-6-7><a id=__codelineno-6-7 name=__codelineno-6-7 href=#__codelineno-6-7></a><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><span id=__span-6-8><a id=__codelineno-6-8 name=__codelineno-6-8 href=#__codelineno-6-8></a><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><span id=__span-6-9><a id=__codelineno-6-9 name=__codelineno-6-9 href=#__codelineno-6-9></a><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><span id=__span-6-10><a id=__codelineno-6-10 name=__codelineno-6-10 href=#__codelineno-6-10></a><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><span id=__span-6-11><a id=__codelineno-6-11 name=__codelineno-6-11 href=#__codelineno-6-11></a><span class=w> </span>-p<span class=w> </span><span class=m>3306</span>:3306<span class=w> </span><span class=se>\</span>
</span><span id=__span-6-12><a id=__codelineno-6-12 name=__codelineno-6-12 href=#__codelineno-6-12></a><span class=w> </span>-v<span class=w> </span>/path/to/mariadb/config:/config<span class=w> </span><span class=se>\</span>
</span><span id=__span-6-13><a id=__codelineno-6-13 name=__codelineno-6-13 href=#__codelineno-6-13></a><span class=w> </span>--restart<span class=w> </span>unless-stopped<span class=w> </span><span class=se>\</span>
</span><span id=__span-6-14><a id=__codelineno-6-14 name=__codelineno-6-14 href=#__codelineno-6-14></a><span class=w> </span>lscr.io/linuxserver/mariadb:latest
</span></code></pre></div> <h2 id=parameters>Parameters<a class=headerlink href=#parameters title="Permanent link">&para;</a></h2> <p>Containers 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>)<a class=headerlink href=#ports-p title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th style="text-align: center;">Parameter</th> <th>Function</th> </tr> </thead> <tbody> <tr> <td style="text-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>)<a class=headerlink href=#environment-variables-e title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th style="text-align: center;">Env</th> <th>Function</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;"><code>PUID=1000</code></td> <td>for UserID - see below for explanation</td> </tr> <tr> <td style="text-align: center;"><code>PGID=1000</code></td> <td>for GroupID - see below for explanation</td> </tr> <tr> <td style="text-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 style="text-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 style="text-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 style="text-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 style="text-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 style="text-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>)<a class=headerlink href=#volume-mappings-v title="Permanent link">&para;</a></h3> <table> <thead> <tr> <th style="text-align: center;">Volume</th> <th>Function</th> </tr> </thead> <tbody> <tr> <td style="text-align: center;"><code>/config</code></td> <td>Persistent config files</td> </tr> </tbody> </table> <h4 id=miscellaneous-options>Miscellaneous Options<a class=headerlink href=#miscellaneous-options title="Permanent link">&para;</a></h4> <table> <thead> <tr> <th style="text-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)<a class=headerlink href=#environment-variables-from-files-docker-secrets title="Permanent link">&para;</a></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="language-bash highlight"><pre><span></span><code><span id=__span-7-1><a id=__codelineno-7-1 name=__codelineno-7-1 href=#__codelineno-7-1></a>-e<span class=w> </span><span class=nv>FILE__MYVAR</span><span class=o>=</span>/run/secrets/mysecretvariable
</span></code></pre></div> <p>Will set the environment variable <code>MYVAR</code> based on the contents of the <code>/run/secrets/mysecretvariable</code> file.</p> <h2 id=umask-for-running-applications>Umask for running applications<a class=headerlink href=#umask-for-running-applications title="Permanent link">&para;</a></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<a class=headerlink href=#user-group-identifiers title="Permanent link">&para;</a></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 your_user</code> as below:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-8-1><a id=__codelineno-8-1 name=__codelineno-8-1 href=#__codelineno-8-1></a>id<span class=w> </span>your_user
</span></code></pre></div> <p>Example output:</p> <div class="language-text highlight"><pre><span></span><code><span id=__span-9-1><a id=__codelineno-9-1 name=__codelineno-9-1 href=#__codelineno-9-1></a>uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
</span></code></pre></div> <h2 id=docker-mods>Docker Mods<a class=headerlink href=#docker-mods title="Permanent link">&para;</a></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<a class=headerlink href=#support-info title="Permanent link">&para;</a></h2> <ul> <li> <p>Shell access whilst the container is running:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-10-1><a id=__codelineno-10-1 name=__codelineno-10-1 href=#__codelineno-10-1></a>docker<span class=w> </span><span class=nb>exec</span><span class=w> </span>-it<span class=w> </span>mariadb<span class=w> </span>/bin/bash
</span></code></pre></div> </li> <li> <p>To monitor the logs of the container in realtime:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-11-1><a id=__codelineno-11-1 name=__codelineno-11-1 href=#__codelineno-11-1></a>docker<span class=w> </span>logs<span class=w> </span>-f<span class=w> </span>mariadb
</span></code></pre></div> </li> <li> <p>Container version number:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-12-1><a id=__codelineno-12-1 name=__codelineno-12-1 href=#__codelineno-12-1></a>docker<span class=w> </span>inspect<span class=w> </span>-f<span class=w> </span><span class=s1>&#39;{{ index .Config.Labels &quot;build_version&quot; }}&#39;</span><span class=w> </span>mariadb
</span></code></pre></div> </li> <li> <p>Image version number:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-13-1><a id=__codelineno-13-1 name=__codelineno-13-1 href=#__codelineno-13-1></a>docker<span class=w> </span>inspect<span class=w> </span>-f<span class=w> </span><span class=s1>&#39;{{ index .Config.Labels &quot;build_version&quot; }}&#39;</span><span class=w> </span>lscr.io/linuxserver/mariadb:latest
</span></code></pre></div> </li> </ul> <h2 id=updating-info>Updating Info<a class=headerlink href=#updating-info title="Permanent link">&para;</a></h2> <p>Most of our images are static, versioned, and require an image update and container recreation to update the app inside. With some exceptions (noted in the relevant readme.md), we do not recommend or support updating apps inside the container. Please consult the <a href=#application-setup>Application Setup</a> section above to see if it is recommended for the image.</p> <p>Below are the instructions for updating containers:</p> <h3 id=via-docker-compose>Via Docker Compose<a class=headerlink href=#via-docker-compose title="Permanent link">&para;</a></h3> <ul> <li> <p>Update images:</p> <ul> <li> <p>All images:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-14-1><a id=__codelineno-14-1 name=__codelineno-14-1 href=#__codelineno-14-1></a>docker-compose<span class=w> </span>pull
</span></code></pre></div> </li> <li> <p>Single image:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-15-1><a id=__codelineno-15-1 name=__codelineno-15-1 href=#__codelineno-15-1></a>docker-compose<span class=w> </span>pull<span class=w> </span>mariadb
</span></code></pre></div> </li> </ul> </li> <li> <p>Update containers:</p> <ul> <li> <p>All containers:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-16-1><a id=__codelineno-16-1 name=__codelineno-16-1 href=#__codelineno-16-1></a>docker-compose<span class=w> </span>up<span class=w> </span>-d
</span></code></pre></div> </li> <li> <p>Single container:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-17-1><a id=__codelineno-17-1 name=__codelineno-17-1 href=#__codelineno-17-1></a>docker-compose<span class=w> </span>up<span class=w> </span>-d<span class=w> </span>mariadb
</span></code></pre></div> </li> </ul> </li> <li> <p>You can also remove the old dangling images:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-18-1><a id=__codelineno-18-1 name=__codelineno-18-1 href=#__codelineno-18-1></a>docker<span class=w> </span>image<span class=w> </span>prune
</span></code></pre></div> </li> </ul> <h3 id=via-docker-run>Via Docker Run<a class=headerlink href=#via-docker-run title="Permanent link">&para;</a></h3> <ul> <li> <p>Update the image:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-19-1><a id=__codelineno-19-1 name=__codelineno-19-1 href=#__codelineno-19-1></a>docker<span class=w> </span>pull<span class=w> </span>lscr.io/linuxserver/mariadb:latest
</span></code></pre></div> </li> <li> <p>Stop the running container:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-20-1><a id=__codelineno-20-1 name=__codelineno-20-1 href=#__codelineno-20-1></a>docker<span class=w> </span>stop<span class=w> </span>mariadb
</span></code></pre></div> </li> <li> <p>Delete the container:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-21-1><a id=__codelineno-21-1 name=__codelineno-21-1 href=#__codelineno-21-1></a>docker<span class=w> </span>rm<span class=w> </span>mariadb
</span></code></pre></div> </li> <li> <p>Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your <code>/config</code> folder and settings will be preserved)</p> </li> <li> <p>You can also remove the old dangling images:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-22-1><a id=__codelineno-22-1 name=__codelineno-22-1 href=#__codelineno-22-1></a>docker<span class=w> </span>image<span class=w> </span>prune
</span></code></pre></div> </li> </ul> <h3 id=image-update-notifications-diun-docker-image-update-notifier>Image Update Notifications - Diun (Docker Image Update Notifier)<a class=headerlink href=#image-update-notifications-diun-docker-image-update-notifier title="Permanent link">&para;</a></h3> <div class="admonition tip"> <p class=admonition-title>Tip</p> <p>We recommend <a href=https://crazymax.dev/diun/ >Diun</a> for update notifications. Other tools that automatically update containers unattended are not recommended or supported.</p> </div> <h2 id=building-locally>Building locally<a class=headerlink href=#building-locally title="Permanent link">&para;</a></h2> <p>If you want to make local modifications to these images for development purposes or just to customize the logic:</p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-23-1><a id=__codelineno-23-1 name=__codelineno-23-1 href=#__codelineno-23-1></a>git<span class=w> </span>clone<span class=w> </span>https://github.com/linuxserver/docker-mariadb.git
</span><span id=__span-23-2><a id=__codelineno-23-2 name=__codelineno-23-2 href=#__codelineno-23-2></a><span class=nb>cd</span><span class=w> </span>docker-mariadb
</span><span id=__span-23-3><a id=__codelineno-23-3 name=__codelineno-23-3 href=#__codelineno-23-3></a>docker<span class=w> </span>build<span class=w> </span><span class=se>\</span>
</span><span id=__span-23-4><a id=__codelineno-23-4 name=__codelineno-23-4 href=#__codelineno-23-4></a><span class=w> </span>--no-cache<span class=w> </span><span class=se>\</span>
</span><span id=__span-23-5><a id=__codelineno-23-5 name=__codelineno-23-5 href=#__codelineno-23-5></a><span class=w> </span>--pull<span class=w> </span><span class=se>\</span>
</span><span id=__span-23-6><a id=__codelineno-23-6 name=__codelineno-23-6 href=#__codelineno-23-6></a><span class=w> </span>-t<span class=w> </span>lscr.io/linuxserver/mariadb:latest<span class=w> </span>.
</span></code></pre></div> <p>The ARM variants can be built on x86_64 hardware using <code>multiarch/qemu-user-static</code></p> <div class="language-bash highlight"><pre><span></span><code><span id=__span-24-1><a id=__codelineno-24-1 name=__codelineno-24-1 href=#__codelineno-24-1></a>docker<span class=w> </span>run<span class=w> </span>--rm<span class=w> </span>--privileged<span class=w> </span>multiarch/qemu-user-static:register<span class=w> </span>--reset
</span></code></pre></div> <p>Once registered you can define the dockerfile to use with <code>-f Dockerfile.aarch64</code>.</p> <h2 id=versions>Versions<a class=headerlink href=#versions title="Permanent link">&para;</a></h2> <ul> <li><strong>31.05.24:</strong> - Rebase to Alpine 3.20.</li> <li><strong>23.12.23:</strong> - Rebase to Alpine 3.19.</li> <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> <aside class=md-source-file> <span class=md-source-file__fact> <span class=md-icon title="Last update"> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M21 13.1c-.1 0-.3.1-.4.2l-1 1 2.1 2.1 1-1c.2-.2.2-.6 0-.8l-1.3-1.3c-.1-.1-.2-.2-.4-.2m-1.9 1.8-6.1 6V23h2.1l6.1-6.1zM12.5 7v5.2l4 2.4-1 1L11 13V7zM11 21.9c-5.1-.5-9-4.8-9-9.9C2 6.5 6.5 2 12 2c5.3 0 9.6 4.1 10 9.3-.3-.1-.6-.2-1-.2s-.7.1-1 .2C19.6 7.2 16.2 4 12 4c-4.4 0-8 3.6-8 8 0 4.1 3.1 7.5 7.1 7.9l-.1.2z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">July 10, 2024</span> </span> <span class=md-source-file__fact> <span class=md-icon title=Created> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24 24"><path d="M14.47 15.08 11 13V7h1.5v5.25l3.08 1.83c-.41.28-.79.62-1.11 1m-1.39 4.84c-.36.05-.71.08-1.08.08-4.42 0-8-3.58-8-8s3.58-8 8-8 8 3.58 8 8c0 .37-.03.72-.08 1.08.69.1 1.33.32 1.92.64.1-.56.16-1.13.16-1.72 0-5.5-4.5-10-10-10S2 6.5 2 12s4.47 10 10 10c.59 0 1.16-.06 1.72-.16-.32-.59-.54-1.23-.64-1.92M18 15v3h-3v2h3v3h2v-3h3v-2h-3v-3z"/></svg> </span> <span class="git-revision-date-localized-plugin git-revision-date-localized-plugin-date">February 9, 2019</span> </span> </aside> </article> </div> <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script> </div> <button type=button class="md-top md-icon" data-md-component=top hidden> <svg xmlns=http://www.w3.org/2000/svg viewbox="0 0 24