Skip to content

Commit d931edc

Browse files
Run update.sh
1 parent 4a4afd9 commit d931edc

File tree

1 file changed

+17
-7
lines changed

1 file changed

+17
-7
lines changed

mariadb/README.md

Lines changed: 17 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -81,24 +81,34 @@ The mariadb has a number of tags, and of note is `latest`, as the latest stable
8181

8282
## Running the container
8383

84+
### Configuration
85+
86+
#### Port binding
87+
88+
By default, the database running within the container will listen on port 3306. You can expose the container port 3306 to the host port 3306 with the `-p 3306:3306` argument to `docker run`, like the command below:
89+
90+
```console
91+
$ docker run --name some-mariadb -p 3306:3306 mariadb:latest
92+
```
93+
8494
### Starting using a minimal configuration
8595

8696
The environment variables required to use this image involves the setting of the root user password:
8797

8898
```console
89-
$ docker run --detach --name some-mariadb --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest
99+
$ docker run --detach --name some-mariadb --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest
90100
```
91101

92102
or:
93103

94104
```console
95-
$ docker run --detach --name some-mariadb --env MARIADB_ALLOW_EMPTY_ROOT_PASSWORD=1 mariadb:latest
105+
$ docker run --detach --name some-mariadb --env MARIADB_ALLOW_EMPTY_ROOT_PASSWORD=1 mariadb:latest
96106
```
97107

98108
or:
99109

100110
```console
101-
$ docker run --detach --name some-mariadb --env MARIADB_RANDOM_ROOT_PASSWORD=1 mariadb:latest
111+
$ docker run --detach --name some-mariadb --env MARIADB_RANDOM_ROOT_PASSWORD=1 mariadb:latest
102112
```
103113

104114
... where the container logs will contain the generated root password.
@@ -132,7 +142,7 @@ Run `docker compose up`, wait for it to initialize completely, and visit `http:/
132142
Starting a MariaDB instance with a user, password, and a database:
133143

134144
```console
135-
$ docker run --detach --name some-mariadb --env MARIADB_USER=example-user --env MARIADB_PASSWORD=my_cool_secret --env MARIADB_DATABASE=exmple-database --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest
145+
$ docker run --detach --name some-mariadb --env MARIADB_USER=example-user --env MARIADB_PASSWORD=my_cool_secret --env MARIADB_DATABASE=exmple-database --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest
136146
```
137147

138148
### Start a `mariadb` server instance in a network
@@ -141,8 +151,8 @@ As applications talk to MariaDB, MariaDB needs to start in the same network as t
141151

142152
```console
143153
$ docker network create some-network
144-
$ docker run --detach --network some-network --name some-mariadb --env MARIADB_USER=example-user --env MARIADB_PASSWORD=my_cool_secret --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest
145-
$ docker run --detach --network some-network --name some-application --env APP_DB_HOST=some-mariadb --env APP_DB_USER=example-user --env APP_DB_PASSWD=my_cool_secret some-application
154+
$ docker run --detach --network some-network --name some-mariadb --env MARIADB_USER=example-user --env MARIADB_PASSWORD=my_cool_secret --env MARIADB_ROOT_PASSWORD=my-secret-pw mariadb:latest
155+
$ docker run --detach --network some-network --name some-application --env APP_DB_HOST=some-mariadb --env APP_DB_USER=example-user --env APP_DB_PASSWD=my_cool_secret some-application
146156
```
147157

148158
... where `some-network` is a newly created network (other than `bridge` as the default network), `some-mariadb` is the name you want to assign to your container, `my-secret-pw` is the password to be set for the MariaDB root user. See the list above for relevant tags to match your needs and environment. `some-application` and then environment variable `APP_DB_HOST`, `APP_DB_USER` and `APP_DB_PASSWD` are the application's configuration for its database connection.
@@ -152,7 +162,7 @@ $ docker run --detach --network some-network --name some-application --env APP_D
152162
The following command starts another `mariadb` container instance and runs the `mariadb` command line client against your original `mariadb` container, allowing you to execute SQL statements against your database instance:
153163

154164
```console
155-
$ docker run -it --network some-network --rm mariadb mariadb -hsome-mariadb -uexample-user -p
165+
$ docker run -it --network some-network --rm mariadb mariadb -h some-mariadb -u example-user
156166
```
157167

158168
... where `some-mariadb` is the name of your original `mariadb` container (connected to the `some-network` Docker network).

0 commit comments

Comments
 (0)