aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/md/docker/shaarli-images.md
diff options
context:
space:
mode:
authorVirtualTam <virtualtam+github@flibidi.net>2017-07-29 16:17:09 +0200
committerGitHub <noreply@github.com>2017-07-29 16:17:09 +0200
commitfccfa09df84011f363311c44fa1b374ba7cd9af8 (patch)
treea5f9a26ce2033182fd0d13c9035b44ff9ebbf9fe /doc/md/docker/shaarli-images.md
parent57ee53d6c6be4b641764b0a635b2998c6cdc8197 (diff)
parent3a6f91a9ccbdd8f2ed8e33c88c7800f2623cfd3a (diff)
downloadShaarli-fccfa09df84011f363311c44fa1b374ba7cd9af8.tar.gz
Shaarli-fccfa09df84011f363311c44fa1b374ba7cd9af8.tar.zst
Shaarli-fccfa09df84011f363311c44fa1b374ba7cd9af8.zip
Merge pull request #906 from virtualtam/docker/cleanup
docker: remove `dev` image, update documentation
Diffstat (limited to 'doc/md/docker/shaarli-images.md')
-rw-r--r--doc/md/docker/shaarli-images.md71
1 files changed, 71 insertions, 0 deletions
diff --git a/doc/md/docker/shaarli-images.md b/doc/md/docker/shaarli-images.md
new file mode 100644
index 00000000..6d108d21
--- /dev/null
+++ b/doc/md/docker/shaarli-images.md
@@ -0,0 +1,71 @@
1## Get and run a Shaarli image
2
3### DockerHub repository
4The images can be found in the [`shaarli/shaarli`](https://hub.docker.com/r/shaarli/shaarli/)
5repository.
6
7### Available image tags
8- `latest`: master branch (tarball release)
9- `stable`: stable branch (tarball release)
10
11All images rely on:
12- [Debian 8 Jessie](https://hub.docker.com/_/debian/)
13- [PHP5-FPM](http://php-fpm.org/)
14- [Nginx](http://nginx.org/)
15
16### Download from DockerHub
17```bash
18$ docker pull shaarli/shaarli
19latest: Pulling from shaarli/shaarli
2032716d9fcddb: Pull complete
2184899d045435: Pull complete
224b6ad7444763: Pull complete
23e0345ef7a3e0: Pull complete
245c1dd344094f: Pull complete
256422305a200b: Pull complete
267d63f861dbef: Pull complete
273eb97210645c: Pull complete
28869319d746ff: Already exists
29869319d746ff: Pulling fs layer
30902b87aaaec9: Already exists
31Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98
32Status: Downloaded newer image for shaarli/shaarli:latest
33```
34
35### Create and start a new container from the image
36```bash
37# map the host's :8000 port to the container's :80 port
38$ docker create -p 8000:80 shaarli/shaarli
39d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
40
41# launch the container in the background
42$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
43d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
44
45# list active containers
46$ docker ps
47CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
48d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 15 seconds ago Up 4 seconds 0.0.0.0:8000->80/tcp backstabbing_galileo
49```
50
51### Stop and destroy a container
52```bash
53$ docker stop backstabbing_galileo # those docker guys are really rude to physicists!
54backstabbing_galileo
55
56# check the container is stopped
57$ docker ps
58CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
59
60# list ALL containers
61$ docker ps -a
62CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
63d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 5 minutes ago Exited (0) 48 seconds ago backstabbing_galileo
64
65# destroy the container
66$ docker rm backstabbing_galileo # let's put an end to these barbarian practices
67backstabbing_galileo
68
69$ docker ps -a
70CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
71```