You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
The ARM variants can be built on x86_64 hardware using `multiarch/qemu-user-static`
109
-
```
109
+
110
+
```bash
110
111
docker run --rm --privileged multiarch/qemu-user-static:register --reset
111
112
```
112
113
113
114
Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64`.
114
115
115
-
## Update the chagelog
116
+
## Update the changelog
116
117
117
-
If you are modifying the Dockerfiles or any of the startup scripts in [root](https://github.com/linuxserver/docker-mariadb/tree/master/root), add an entry to the changelog
118
+
If you are modifying the Dockerfiles or any of the startup scripts in [root](https://github.com/linuxserver/docker-mariadb/tree/alpine/root), add an entry to the changelog
Copy file name to clipboardExpand all lines: .github/PULL_REQUEST_TEMPLATE.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -21,7 +21,7 @@
21
21
22
22
------------------------------
23
23
24
-
-[ ] I have read the [contributing](https://github.com/linuxserver/docker-mariadb/blob/master/.github/CONTRIBUTING.md) guideline and understand that I have made the correct modifications
24
+
-[ ] I have read the [contributing](https://github.com/linuxserver/docker-mariadb/blob/alpine/.github/CONTRIBUTING.md) guideline and understand that I have made the correct modifications
Copy file name to clipboardExpand all lines: .github/workflows/greetings.yml
+2-2Lines changed: 2 additions & 2 deletions
Original file line number
Diff line number
Diff line change
@@ -8,6 +8,6 @@ jobs:
8
8
steps:
9
9
- uses: actions/first-interaction@v1
10
10
with:
11
-
issue-message: 'Thanks for opening your first issue here! Be sure to follow the [bug](https://github.com/linuxserver/docker-mariadb/blob/master/.github/ISSUE_TEMPLATE/issue.bug.md) or [feature](https://github.com/linuxserver/docker-mariadb/blob/master/.github/ISSUE_TEMPLATE/issue.feature.md) issue templates!'
12
-
pr-message: 'Thanks for opening this pull request! Be sure to follow the [pull request template](https://github.com/linuxserver/docker-mariadb/blob/master/.github/PULL_REQUEST_TEMPLATE.md)!'
11
+
issue-message: 'Thanks for opening your first issue here! Be sure to follow the [bug](https://github.com/linuxserver/docker-mariadb/blob/alpine/.github/ISSUE_TEMPLATE/issue.bug.md) or [feature](https://github.com/linuxserver/docker-mariadb/blob/alpine/.github/ISSUE_TEMPLATE/issue.feature.md) issue templates!'
12
+
pr-message: 'Thanks for opening this pull request! Be sure to follow the [pull request template](https://github.com/linuxserver/docker-mariadb/blob/alpine/.github/PULL_REQUEST_TEMPLATE.md)!'
@@ -65,6 +65,50 @@ This image provides various versions that are available via tags. `latest` tag u
65
65
| latest | Currently using Ubuntu base images. Will be moved to the Alpine base in the near future. |
66
66
| alpine | Releases with an Alpine base. |
67
67
68
+
## Application Setup
69
+
70
+
If you didn't set a password during installation, (see logs for warning) use
71
+
`mysqladmin -u root password <PASSWORD>`
72
+
to set one at the docker prompt...
73
+
74
+
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.
75
+
76
+
NOTE if you want to use (MYSQL_DATABASE MYSQL_USER MYSQL_PASSWORD) **all three** of these variables need to be set you cannot pick and choose.
77
+
78
+
Unraid users, it is advisable to edit the template/webui after setup and remove reference to this variable.
79
+
80
+
Find custom.cnf in /config for config changes (restart container for them to take effect)
81
+
, the databases in /config/databases and the log in /config/log/myqsl
82
+
83
+
### Loading passwords and users from files
84
+
85
+
The `MYSQL_ROOT_PASSWORD MYSQL_DATABASE MYSQL_USER MYSQL_PASSWORD REMOTE_SQL` env values can be set in a file:
These settings can be mixed and matched with Docker ENV settings as you require, but the settings in the file will always take precedence.
102
+
103
+
### Bootstrapping a new instance
104
+
105
+
We support a one time run of custom sql files on init. In order to use this place `*.sql` files in:
106
+
107
+
```
108
+
/config/initdb.d/
109
+
```
110
+
This will have the same effect as setting the `REMOTE_SQL` environment variable. The sql will only be run on the containers first boot and setup.
111
+
68
112
## Usage
69
113
70
114
Here are some example snippets to help you get started creating a container.
@@ -98,7 +142,7 @@ services:
98
142
99
143
### docker cli
100
144
101
-
```
145
+
```bash
102
146
docker run -d \
103
147
--name=mariadb \
104
148
-e PUID=1000 \
@@ -115,7 +159,6 @@ docker run -d \
115
159
ghcr.io/linuxserver/mariadb
116
160
```
117
161
118
-
119
162
## Parameters
120
163
121
164
Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `<external>:<internal>` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.
@@ -139,7 +182,7 @@ You can set any environment variable from a file by using a special prepend `FIL
139
182
140
183
As an example:
141
184
142
-
```
185
+
```bash
143
186
-e FILE__PASSWORD=/run/secrets/mysecretpassword
144
187
```
145
188
@@ -158,64 +201,17 @@ Ensure any volume directories on the host are owned by the same user you specify
158
201
159
202
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
If you didn't set a password during installation, (see logs for warning) use
171
-
`mysqladmin -u root password <PASSWORD>`
172
-
to set one at the docker prompt...
173
-
174
-
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.
175
-
176
-
NOTE if you want to use (MYSQL_DATABASE MYSQL_USER MYSQL_PASSWORD) **all three** of these variables need to be set you cannot pick and choose.
177
-
178
-
Unraid users, it is advisable to edit the template/webui after setup and remove reference to this variable.
179
-
180
-
Find custom.cnf in /config for config changes (restart container for them to take effect)
181
-
, the databases in /config/databases and the log in /config/log/myqsl
182
-
183
-
### Loading passwords and users from files
184
-
185
-
The `MYSQL_ROOT_PASSWORD MYSQL_DATABASE MYSQL_USER MYSQL_PASSWORD REMOTE_SQL` env values can be set in a file:
These settings can be mixed and matched with Docker ENV settings as you require, but the settings in the file will always take precedence.
202
-
203
-
### Bootstrapping a new instance
204
-
205
-
We support a one time run of custom sql files on init. In order to use this place `*.sql` files in:
206
-
207
-
```
208
-
/config/initdb.d/
209
-
```
210
-
This will have the same effect as setting the `REMOTE_SQL` environment variable. The sql will only be run on the containers first boot and setup.
211
-
212
-
213
209
## Docker Mods
210
+
214
211
[](https://mods.linuxserver.io/?mod=mariadb"view available mods for this container.")[](https://mods.linuxserver.io/?mod=universal"view available universal mods.")
215
212
216
213
We publish various [Docker Mods](https://github.com/linuxserver/docker-mods) 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.
217
214
218
-
219
215
## Support Info
220
216
221
217
* Shell access whilst the container is running: `docker exec -it mariadb /bin/bash`
@@ -232,38 +228,45 @@ Most of our images are static, versioned, and require an image update and contai
232
228
Below are the instructions for updating containers:
233
229
234
230
### Via Docker Compose
231
+
235
232
* Update all images: `docker-compose pull`
236
233
* or update a single image: `docker-compose pull mariadb`
237
234
* Let compose update all containers as necessary: `docker-compose up -d`
238
235
* or update a single container: `docker-compose up -d mariadb`
239
236
* You can also remove the old dangling images: `docker image prune`
240
237
241
238
### Via Docker Run
239
+
242
240
* Update the image: `docker pull ghcr.io/linuxserver/mariadb`
243
241
* Stop the running container: `docker stop mariadb`
244
242
* Delete the container: `docker rm mariadb`
245
243
* Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your `/config` folder and settings will be preserved)
246
244
* You can also remove the old dangling images: `docker image prune`
247
245
248
246
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
247
+
249
248
* Pull the latest image at its tag and replace it with the same env variables in one run:
250
-
```
249
+
250
+
```bash
251
251
docker run --rm \
252
252
-v /var/run/docker.sock:/var/run/docker.sock \
253
253
containrrr/watchtower \
254
254
--run-once mariadb
255
255
```
256
+
256
257
* You can also remove the old dangling images: `docker image prune`
257
258
258
259
**Note:** We do not endorse the use of Watchtower as a solution to automated updates of existing Docker containers. In fact we generally discourage automated updates. However, this is a useful tool for one-time manual updates of containers where you have forgotten the original parameters. In the long term, we highly recommend using [Docker Compose](https://docs.linuxserver.io/general/docker-compose).
* We recommend [Diun](https://crazymax.dev/diun/) for update notifications. Other tools that automatically update containers unattended are not recommended or supported.
262
264
263
265
## Building locally
264
266
265
267
If you want to make local modifications to these images for development purposes or just to customize the logic:
0 commit comments