[github/shaarli/Shaarli.git] / doc / html / docker / shaarli-images / index.html

<!DOCTYPE html>
<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  
  
  <link rel="shortcut icon" href="../../img/favicon.ico">
  <title>Shaarli images - Shaarli Documentation</title>
  <link href='https://fonts.googleapis.com/css?family=Lato:400,700|Roboto+Slab:400,700|Inconsolata:400,700' rel='stylesheet' type='text/css'>

  <link rel="stylesheet" href="../../css/theme.css" type="text/css" />
  <link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" />
  <link rel="stylesheet" href="../../css/highlight.css">
  <link href="../../github-markdown.css" rel="stylesheet">
  
  <script>
    // Current page data
    var mkdocs_page_name = "Shaarli images";
    var mkdocs_page_input_path = "docker/shaarli-images.md";
    var mkdocs_page_url = "/docker/shaarli-images/";
  </script>
  
  <script src="../../js/jquery-2.1.1.min.js"></script>
  <script src="../../js/modernizr-2.8.3.min.js"></script>
  <script type="text/javascript" src="../../js/highlight.pack.js"></script> 
  
</head>

<body class="wy-body-for-nav" role="document">

  <div class="wy-grid-for-nav">

    
    <nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
      <div class="wy-side-nav-search">
        <a href="../.." class="icon icon-home"> Shaarli Documentation</a>
        <div role="search">
  <form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
    <input type="text" name="q" placeholder="Search docs" />
  </form>
</div>
      </div>

      <div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
	<ul class="current">
	  
          
            <li class="toctree-l1">
		
    <a class="" href="../..">Home</a>
	    </li>
          
            <li class="toctree-l1">
		
    <span class="caption-text">Setup</span>
    <ul class="subnav">
                <li class="">
                    
    <a class="" href="../../Download-and-Installation/">Download and Installation</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Upgrade-and-migration/">Upgrade and migration</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Server-requirements/">Server requirements</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Server-configuration/">Server configuration</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Server-security/">Server security</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Shaarli-configuration/">Shaarli configuration</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Plugins/">Plugins</a>
                </li>
    </ul>
	    </li>
          
            <li class="toctree-l1">
		
    <span class="caption-text">Docker</span>
    <ul class="subnav">
                <li class="">
                    
    <a class="" href="../docker-101/">Docker 101</a>
                </li>
                <li class=" current">
                    
    <a class="current" href="./">Shaarli images</a>
    <ul class="subnav">
            
    <li class="toctree-l3"><a href="#get-and-run-a-shaarli-image">Get and run a Shaarli image</a></li>
    
        <ul>
        
            <li><a class="toctree-l4" href="#dockerhub-repository">DockerHub repository</a></li>
        
            <li><a class="toctree-l4" href="#available-image-tags">Available image tags</a></li>
        
            <li><a class="toctree-l4" href="#download-from-dockerhub">Download from DockerHub</a></li>
        
            <li><a class="toctree-l4" href="#create-and-start-a-new-container-from-the-image">Create and start a new container from the image</a></li>
        
            <li><a class="toctree-l4" href="#stop-and-destroy-a-container">Stop and destroy a container</a></li>
        
        </ul>
    

    </ul>
                </li>
                <li class="">
                    
    <a class="" href="../reverse-proxy-configuration/">Reverse proxy configuration</a>
                </li>
                <li class="">
                    
    <a class="" href="../resources/">Docker resources</a>
                </li>
    </ul>
	    </li>
          
            <li class="toctree-l1">
		
    <span class="caption-text">Usage</span>
    <ul class="subnav">
                <li class="">
                    
    <a class="" href="../../Features/">Features</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Bookmarklet/">Bookmarklet</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Browsing-and-searching/">Browsing and searching</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Firefox-share/">Firefox share</a>
                </li>
                <li class="">
                    
    <a class="" href="../../RSS-feeds/">RSS feeds</a>
                </li>
                <li class="">
                    
    <a class="" href="../../REST-API/">REST API</a>
                </li>
    </ul>
	    </li>
          
            <li class="toctree-l1">
		
    <span class="caption-text">How To</span>
    <ul class="subnav">
                <li class="">
                    
    <a class="" href="../../Backup,-restore,-import-and-export/">Backup, restore, import and export</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Various-hacks/">Various hacks</a>
                </li>
    </ul>
	    </li>
          
            <li class="toctree-l1">
		
    <a class="" href="../../Troubleshooting/">Troubleshooting</a>
	    </li>
          
            <li class="toctree-l1">
		
    <span class="caption-text">Development</span>
    <ul class="subnav">
                <li class="">
                    
    <a class="" href="../../Development-guidelines/">Development guidelines</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Continuous-integration-tools/">Continuous integration tools</a>
                </li>
                <li class="">
                    
    <a class="" href="../../GnuPG-signature/">GnuPG signature</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Coding-guidelines/">Coding guidelines</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Directory-structure/">Directory structure</a>
                </li>
                <li class="">
                    
    <a class="" href="../../3rd-party-libraries/">3rd party libraries</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Plugin-System/">Plugin System</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Release-Shaarli/">Release Shaarli</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Versioning-and-Branches/">Versioning and Branches</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Security/">Security</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Static-analysis/">Static analysis</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Theming/">Theming</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Unit-tests/">Unit tests</a>
                </li>
    </ul>
	    </li>
          
            <li class="toctree-l1">
		
    <span class="caption-text">About</span>
    <ul class="subnav">
                <li class="">
                    
    <a class="" href="../../FAQ/">FAQ</a>
                </li>
                <li class="">
                    
    <a class="" href="../../Community-&-Related-software/">Community & Related software</a>
                </li>
    </ul>
	    </li>
          
        </ul>
      </div>
      &nbsp;
    </nav>

    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">

      
      <nav class="wy-nav-top" role="navigation" aria-label="top navigation">
        <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
        <a href="../..">Shaarli Documentation</a>
      </nav>

      
      <div class="wy-nav-content">
        <div class="rst-content">
          <div role="navigation" aria-label="breadcrumbs navigation">
  <ul class="wy-breadcrumbs">
    <li><a href="../..">Docs</a> &raquo;</li>
    
      
        
          <li>Docker &raquo;</li>
        
      
    
    <li>Shaarli images</li>
    <li class="wy-breadcrumbs-aside">
      
        <a href="https://github.com/shaarli/Shaarli/edit/master/docs/docker/shaarli-images.md"
          class="icon icon-github"> Edit on GitHub</a>
      
    </li>
  </ul>
  <hr/>
</div>
          <div role="main">
            <div class="section">
              
                <h2 id="get-and-run-a-shaarli-image">Get and run a Shaarli image</h2>
<h3 id="dockerhub-repository">DockerHub repository</h3>
<p>The images can be found in the <a href="https://hub.docker.com/r/shaarli/shaarli/"><code>shaarli/shaarli</code></a>
repository.</p>
<h3 id="available-image-tags">Available image tags</h3>
<ul>
<li><code>latest</code>: master branch (tarball release)</li>
<li><code>stable</code>: stable branch (tarball release)</li>
</ul>
<p>All images rely on:
- <a href="https://hub.docker.com/_/debian/">Debian 8 Jessie</a>
- <a href="http://php-fpm.org/">PHP5-FPM</a>
- <a href="http://nginx.org/">Nginx</a></p>
<h3 id="download-from-dockerhub">Download from DockerHub</h3>
<pre><code class="bash">$ docker pull shaarli/shaarli
latest: Pulling from shaarli/shaarli
32716d9fcddb: Pull complete
84899d045435: Pull complete
4b6ad7444763: Pull complete
e0345ef7a3e0: Pull complete
5c1dd344094f: Pull complete
6422305a200b: Pull complete
7d63f861dbef: Pull complete
3eb97210645c: Pull complete
869319d746ff: Already exists
869319d746ff: Pulling fs layer
902b87aaaec9: Already exists
Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98
Status: Downloaded newer image for shaarli/shaarli:latest
</code></pre>

<h3 id="create-and-start-a-new-container-from-the-image">Create and start a new container from the image</h3>
<pre><code class="bash"># map the host's :8000 port to the container's :80 port
$ docker create -p 8000:80 shaarli/shaarli
d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101

# launch the container in the background
$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101

# list active containers
$ docker ps
CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
d40b7af693d6  shaarli/shaarli  /usr/bin/supervisor  15 seconds ago  Up 4 seconds  0.0.0.0:8000-&gt;80/tcp  backstabbing_galileo
</code></pre>

<h3 id="stop-and-destroy-a-container">Stop and destroy a container</h3>
<pre><code class="bash">$ docker stop backstabbing_galileo  # those docker guys are really rude to physicists!
backstabbing_galileo

# check the container is stopped
$ docker ps
CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES

# list ALL containers
$ docker ps -a
CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS                      PORTS               NAMES
d40b7af693d6        shaarli/shaarli     /usr/bin/supervisor   5 minutes ago       Exited (0) 48 seconds ago                       backstabbing_galileo

# destroy the container
$ docker rm backstabbing_galileo  # let's put an end to these barbarian practices
backstabbing_galileo

$ docker ps -a
CONTAINER ID  IMAGE            COMMAND               CREATED         STATUS        PORTS                 NAMES
</code></pre>
              
            </div>
          </div>
          <footer>
  
    <div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
      
        <a href="../reverse-proxy-configuration/" class="btn btn-neutral float-right" title="Reverse proxy configuration">Next <span class="icon icon-circle-arrow-right"></span></a>
      
      
        <a href="../docker-101/" class="btn btn-neutral" title="Docker 101"><span class="icon icon-circle-arrow-left"></span> Previous</a>
      
    </div>
  

  <hr/>

  <div role="contentinfo">
    <!-- Copyright etc -->
    
  </div>

  Built with <a href="http://www.mkdocs.org">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
</footer>
	  
        </div>
      </div>

    </section>
    
  </div>

  <div class="rst-versions" role="note" style="cursor: pointer">
    <span class="rst-current-version" data-toggle="rst-current-version">
      
          <a href="https://github.com/shaarli/Shaarli" class="fa fa-github" style="float: left; color: #fcfcfc"> GitHub</a>
      
      
        <span><a href="../docker-101/" style="color: #fcfcfc;">&laquo; Previous</a></span>
      
      
        <span style="margin-left: 15px"><a href="../reverse-proxy-configuration/" style="color: #fcfcfc">Next &raquo;</a></span>
      
    </span>
</div>
    <script src="../../js/theme.js"></script>

</body>
</html>
Commit	Line	Data
53ed6d7d	1	<!DOCTYPE html>
	2	<!--[if IE 8]><html class="no-js lt-ie9" lang="en" > <![endif]-->
	3	<!--[if gt IE 8]><!--> <html class="no-js" lang="en" > <!--<![endif]-->
	4	<head>
	5	<meta charset="utf-8">
	6	<meta http-equiv="X-UA-Compatible" content="IE=edge">
	7	<meta name="viewport" content="width=device-width, initial-scale=1.0">
	8
	9
3a6f91a9	10	<link rel="shortcut icon" href="../../img/favicon.ico">
53ed6d7d	11	<title>Shaarli images - Shaarli Documentation</title>
	12	<link href='https://fonts.googleapis.com/css?family=Lato:400,700\|Roboto+Slab:400,700\|Inconsolata:400,700' rel='stylesheet' type='text/css'>
	13
3a6f91a9 V	14	<link rel="stylesheet" href="../../css/theme.css" type="text/css" />
	15	<link rel="stylesheet" href="../../css/theme_extra.css" type="text/css" />
	16	<link rel="stylesheet" href="../../css/highlight.css">
	17	<link href="../../github-markdown.css" rel="stylesheet">
53ed6d7d	18
	19	<script>
	20	// Current page data
	21	var mkdocs_page_name = "Shaarli images";
3a6f91a9 V	22	var mkdocs_page_input_path = "docker/shaarli-images.md";
3a6f91a9 V	23	var mkdocs_page_url = "/docker/shaarli-images/";
53ed6d7d	24	</script>
53ed6d7d	25
3a6f91a9 V	26	<script src="../../js/jquery-2.1.1.min.js"></script>
	27	<script src="../../js/modernizr-2.8.3.min.js"></script>
	28	<script type="text/javascript" src="../../js/highlight.pack.js"></script>
53ed6d7d	29
	30	</head>
	31
	32	<body class="wy-body-for-nav" role="document">
	33
	34	<div class="wy-grid-for-nav">
	35
	36
	37	<nav data-toggle="wy-nav-shift" class="wy-nav-side stickynav">
	38	<div class="wy-side-nav-search">
3a6f91a9	39	<a href="../.." class="icon icon-home"> Shaarli Documentation</a>
53ed6d7d	40	<div role="search">
3a6f91a9	41	<form id ="rtd-search-form" class="wy-form" action="../../search.html" method="get">
53ed6d7d	42	<input type="text" name="q" placeholder="Search docs" />
	43	</form>
	44	</div>
	45	</div>
	46
	47	<div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="main navigation">
	48	<ul class="current">
	49
	50
	51	<li class="toctree-l1">
	52
3a6f91a9	53	<a class="" href="../..">Home</a>
53ed6d7d	54	</li>
	55
	56	<li class="toctree-l1">
	57
	58	<span class="caption-text">Setup</span>
	59	<ul class="subnav">
	60	<li class="">
	61
3a6f91a9	62	<a class="" href="../../Download-and-Installation/">Download and Installation</a>
53ed6d7d	63	</li>
	64	<li class="">
	65
3a6f91a9	66	<a class="" href="../../Upgrade-and-migration/">Upgrade and migration</a>
53ed6d7d	67	</li>
	68	<li class="">
	69
3a6f91a9	70	<a class="" href="../../Server-requirements/">Server requirements</a>
53ed6d7d	71	</li>
	72	<li class="">
	73
3a6f91a9	74	<a class="" href="../../Server-configuration/">Server configuration</a>
53ed6d7d	75	</li>
	76	<li class="">
	77
3a6f91a9	78	<a class="" href="../../Server-security/">Server security</a>
53ed6d7d	79	</li>
	80	<li class="">
	81
3a6f91a9	82	<a class="" href="../../Shaarli-configuration/">Shaarli configuration</a>
53ed6d7d	83	</li>
	84	<li class="">
	85
3a6f91a9	86	<a class="" href="../../Plugins/">Plugins</a>
53ed6d7d	87	</li>
	88	</ul>
	89	</li>
	90
	91	<li class="toctree-l1">
	92
	93	<span class="caption-text">Docker</span>
	94	<ul class="subnav">
	95	<li class="">
	96
3a6f91a9	97	<a class="" href="../docker-101/">Docker 101</a>
53ed6d7d	98	</li>
	99	<li class=" current">
	100
	101	<a class="current" href="./">Shaarli images</a>
	102	<ul class="subnav">
	103
	104	<li class="toctree-l3"><a href="#get-and-run-a-shaarli-image">Get and run a Shaarli image</a></li>
	105
	106	<ul>
	107
	108	<li><a class="toctree-l4" href="#dockerhub-repository">DockerHub repository</a></li>
	109
	110	<li><a class="toctree-l4" href="#available-image-tags">Available image tags</a></li>
	111
	112	<li><a class="toctree-l4" href="#download-from-dockerhub">Download from DockerHub</a></li>
	113
	114	<li><a class="toctree-l4" href="#create-and-start-a-new-container-from-the-image">Create and start a new container from the image</a></li>
	115
	116	<li><a class="toctree-l4" href="#stop-and-destroy-a-container">Stop and destroy a container</a></li>
	117
	118	</ul>
	119
	120
	121	</ul>
	122	</li>
	123	<li class="">
	124
3a6f91a9	125	<a class="" href="../reverse-proxy-configuration/">Reverse proxy configuration</a>
53ed6d7d	126	</li>
	127	<li class="">
	128
3a6f91a9	129	<a class="" href="../resources/">Docker resources</a>
53ed6d7d	130	</li>
	131	</ul>
	132	</li>
	133
	134	<li class="toctree-l1">
	135
	136	<span class="caption-text">Usage</span>
	137	<ul class="subnav">
	138	<li class="">
	139
3a6f91a9	140	<a class="" href="../../Features/">Features</a>
53ed6d7d	141	</li>
	142	<li class="">
	143
3a6f91a9	144	<a class="" href="../../Bookmarklet/">Bookmarklet</a>
53ed6d7d	145	</li>
	146	<li class="">
	147
3a6f91a9	148	<a class="" href="../../Browsing-and-searching/">Browsing and searching</a>
53ed6d7d	149	</li>
	150	<li class="">
	151
3a6f91a9	152	<a class="" href="../../Firefox-share/">Firefox share</a>
53ed6d7d	153	</li>
	154	<li class="">
	155
3a6f91a9	156	<a class="" href="../../RSS-feeds/">RSS feeds</a>
53ed6d7d	157	</li>
	158	<li class="">
	159
3a6f91a9	160	<a class="" href="../../REST-API/">REST API</a>
53ed6d7d	161	</li>
	162	</ul>
	163	</li>
	164
	165	<li class="toctree-l1">
	166
	167	<span class="caption-text">How To</span>
	168	<ul class="subnav">
	169	<li class="">
	170
3a6f91a9	171	<a class="" href="../../Backup,-restore,-import-and-export/">Backup, restore, import and export</a>
53ed6d7d	172	</li>
	173	<li class="">
	174
3a6f91a9	175	<a class="" href="../../Various-hacks/">Various hacks</a>
53ed6d7d	176	</li>
	177	</ul>
	178	</li>
	179
	180	<li class="toctree-l1">
	181
3a6f91a9	182	<a class="" href="../../Troubleshooting/">Troubleshooting</a>
53ed6d7d	183	</li>
	184
	185	<li class="toctree-l1">
	186
	187	<span class="caption-text">Development</span>
	188	<ul class="subnav">
	189	<li class="">
	190
3a6f91a9	191	<a class="" href="../../Development-guidelines/">Development guidelines</a>
53ed6d7d	192	</li>
	193	<li class="">
	194
3a6f91a9	195	<a class="" href="../../Continuous-integration-tools/">Continuous integration tools</a>
53ed6d7d	196	</li>
	197	<li class="">
	198
3a6f91a9	199	<a class="" href="../../GnuPG-signature/">GnuPG signature</a>
53ed6d7d	200	</li>
	201	<li class="">
	202
3a6f91a9	203	<a class="" href="../../Coding-guidelines/">Coding guidelines</a>
53ed6d7d	204	</li>
	205	<li class="">
	206
3a6f91a9	207	<a class="" href="../../Directory-structure/">Directory structure</a>
53ed6d7d	208	</li>
	209	<li class="">
	210
3a6f91a9	211	<a class="" href="../../3rd-party-libraries/">3rd party libraries</a>
53ed6d7d	212	</li>
	213	<li class="">
	214
3a6f91a9	215	<a class="" href="../../Plugin-System/">Plugin System</a>
53ed6d7d	216	</li>
	217	<li class="">
	218
3a6f91a9	219	<a class="" href="../../Release-Shaarli/">Release Shaarli</a>
53ed6d7d	220	</li>
	221	<li class="">
	222
3a6f91a9	223	<a class="" href="../../Versioning-and-Branches/">Versioning and Branches</a>
53ed6d7d	224	</li>
	225	<li class="">
	226
3a6f91a9	227	<a class="" href="../../Security/">Security</a>
53ed6d7d	228	</li>
	229	<li class="">
	230
3a6f91a9	231	<a class="" href="../../Static-analysis/">Static analysis</a>
53ed6d7d	232	</li>
	233	<li class="">
	234
3a6f91a9	235	<a class="" href="../../Theming/">Theming</a>
53ed6d7d	236	</li>
	237	<li class="">
	238
3a6f91a9	239	<a class="" href="../../Unit-tests/">Unit tests</a>
53ed6d7d	240	</li>
	241	</ul>
	242	</li>
	243
	244	<li class="toctree-l1">
	245
	246	<span class="caption-text">About</span>
	247	<ul class="subnav">
	248	<li class="">
	249
3a6f91a9	250	<a class="" href="../../FAQ/">FAQ</a>
53ed6d7d	251	</li>
	252	<li class="">
	253
3a6f91a9	254	<a class="" href="../../Community-&-Related-software/">Community & Related software</a>
53ed6d7d	255	</li>
	256	</ul>
	257	</li>
	258
	259	</ul>
	260	</div>
	261
	262	</nav>
	263
	264	<section data-toggle="wy-nav-shift" class="wy-nav-content-wrap">
	265
	266
	267	<nav class="wy-nav-top" role="navigation" aria-label="top navigation">
	268	<i data-toggle="wy-nav-top" class="fa fa-bars"></i>
3a6f91a9	269	<a href="../..">Shaarli Documentation</a>
53ed6d7d	270	</nav>
	271
	272
	273	<div class="wy-nav-content">
	274	<div class="rst-content">
	275	<div role="navigation" aria-label="breadcrumbs navigation">
	276	<ul class="wy-breadcrumbs">
3a6f91a9	277	<li><a href="../..">Docs</a> »</li>
53ed6d7d	278
	279
	280
	281	<li>Docker »</li>
	282
	283
	284
	285	<li>Shaarli images</li>
	286	<li class="wy-breadcrumbs-aside">
	287
3a6f91a9	288	<a href="https://github.com/shaarli/Shaarli/edit/master/docs/docker/shaarli-images.md"
53ed6d7d	289	class="icon icon-github"> Edit on GitHub</a>
	290
	291	</li>
	292	</ul>
	293	<hr/>
	294	</div>
	295	<div role="main">
	296	<div class="section">
	297
	298	<h2 id="get-and-run-a-shaarli-image">Get and run a Shaarli image</h2>
	299	<h3 id="dockerhub-repository">DockerHub repository</h3>
	300	<p>The images can be found in the <a href="https://hub.docker.com/r/shaarli/shaarli/"><code>shaarli/shaarli</code></a>
	301	repository.</p>
	302	<h3 id="available-image-tags">Available image tags</h3>
	303	<ul>
	304	<li><code>latest</code>: master branch (tarball release)</li>
	305	<li><code>stable</code>: stable branch (tarball release)</li>
53ed6d7d	306	</ul>
	307	<p>All images rely on:
	308	- <a href="https://hub.docker.com/_/debian/">Debian 8 Jessie</a>
	309	- <a href="http://php-fpm.org/">PHP5-FPM</a>
	310	- <a href="http://nginx.org/">Nginx</a></p>
	311	<h3 id="download-from-dockerhub">Download from DockerHub</h3>
	312	<pre><code class="bash">$ docker pull shaarli/shaarli
	313	latest: Pulling from shaarli/shaarli
	314	32716d9fcddb: Pull complete
	315	84899d045435: Pull complete
	316	4b6ad7444763: Pull complete
	317	e0345ef7a3e0: Pull complete
	318	5c1dd344094f: Pull complete
	319	6422305a200b: Pull complete
	320	7d63f861dbef: Pull complete
	321	3eb97210645c: Pull complete
	322	869319d746ff: Already exists
	323	869319d746ff: Pulling fs layer
	324	902b87aaaec9: Already exists
	325	Digest: sha256:f836b4627b958b3f83f59c332f22f02fcd495ace3056f2be2c4912bd8704cc98
	326	Status: Downloaded newer image for shaarli/shaarli:latest
	327	</code></pre>
	328
	329	<h3 id="create-and-start-a-new-container-from-the-image">Create and start a new container from the image</h3>
	330	<pre><code class="bash"># map the host's :8000 port to the container's :80 port
	331	$ docker create -p 8000:80 shaarli/shaarli
	332	d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
	333
	334	# launch the container in the background
	335	$ docker start d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
	336	d40b7af693d678958adedfb88f87d6ea0237186c23de5c4102a55a8fcb499101
	337
	338	# list active containers
	339	$ docker ps
	340	CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
	341	d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 15 seconds ago Up 4 seconds 0.0.0.0:8000->80/tcp backstabbing_galileo
	342	</code></pre>
	343
	344	<h3 id="stop-and-destroy-a-container">Stop and destroy a container</h3>
	345	<pre><code class="bash">$ docker stop backstabbing_galileo # those docker guys are really rude to physicists!
	346	backstabbing_galileo
	347
	348	# check the container is stopped
	349	$ docker ps
	350	CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
	351
	352	# list ALL containers
	353	$ docker ps -a
	354	CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
	355	d40b7af693d6 shaarli/shaarli /usr/bin/supervisor 5 minutes ago Exited (0) 48 seconds ago backstabbing_galileo
	356
	357	# destroy the container
	358	$ docker rm backstabbing_galileo # let's put an end to these barbarian practices
	359	backstabbing_galileo
	360
	361	$ docker ps -a
	362	CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
	363	</code></pre>
	364
	365	</div>
	366	</div>
	367	<footer>
	368
	369	<div class="rst-footer-buttons" role="navigation" aria-label="footer navigation">
370
3a6f91a9	371	<a href="../reverse-proxy-configuration/" class="btn btn-neutral float-right" title="Reverse proxy configuration">Next <span class="icon icon-circle-arrow-right"></span></a>
53ed6d7d	372
53ed6d7d	373
3a6f91a9	374	<a href="../docker-101/" class="btn btn-neutral" title="Docker 101"><span class="icon icon-circle-arrow-left"></span> Previous</a>
53ed6d7d	375
	376	</div>
	377
	378
	379	<hr/>
	380
	381	<div role="contentinfo">
	382	<!-- Copyright etc -->
	383
	384	</div>
	385
	386	Built with <a href="http://www.mkdocs.org">MkDocs</a> using a <a href="https://github.com/snide/sphinx_rtd_theme">theme</a> provided by <a href="https://readthedocs.org">Read the Docs</a>.
	387	</footer>
	388
	389	</div>
	390	</div>
	391
	392	</section>
	393
	394	</div>
	395
	396	<div class="rst-versions" role="note" style="cursor: pointer">
	397	<span class="rst-current-version" data-toggle="rst-current-version">
	398
	399	<a href="https://github.com/shaarli/Shaarli" class="fa fa-github" style="float: left; color: #fcfcfc"> GitHub</a>
	400
	401
3a6f91a9	402	<span><a href="../docker-101/" style="color: #fcfcfc;">« Previous</a></span>
53ed6d7d	403
53ed6d7d	404
3a6f91a9	405	<span style="margin-left: 15px"><a href="../reverse-proxy-configuration/" style="color: #fcfcfc">Next »</a></span>
53ed6d7d	406
	407	</span>
	408	</div>
3a6f91a9	409	<script src="../../js/theme.js"></script>
53ed6d7d	410
	411	</body>
	412	</html>