peterguo
/
laradock


			
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631
							<!DOCTYPE html>
  
  
   <html class="no-js"> 

  <head lang="en-us">
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
    <meta http-equiv="X-UA-Compatible" content="IE=10" />
    <title>Getting Started - Laradock</title>
    <meta name="generator" content="Hugo 0.18.1" />

    
    <meta name="description" content="Laradock documentations.">
    
    <link rel="canonical" href="http://laradock.io/getting-started/">
    
    <meta name="author" content="Mahmoud Zalt">
    

    <meta property="og:url" content="http://laradock.io/getting-started/">
    <meta property="og:title" content="Laradock">
    
    <meta name="apple-mobile-web-app-title" content="Laradock">
    <meta name="apple-mobile-web-app-capable" content="yes">
    <meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">

    <link rel="shortcut icon" type="image/x-icon" href="http://laradock.io/images/favicon.ico">
    <link rel="icon" type="image/x-icon" href="http://laradock.io/images/favicon.ico">

    <style>
      @font-face {
        font-family: 'Icon';
        src: url('http://laradock.io/fonts/icon.eot');
        src: url('http://laradock.io/fonts/icon.eot')
               format('embedded-opentype'),
             url('http://laradock.io/fonts/icon.woff')
               format('woff'),
             url('http://laradock.io/fonts/icon.ttf')
               format('truetype'),
             url('http://laradock.io/fonts/icon.svg')
               format('svg');
        font-weight: normal;
        font-style: normal;
      }
    </style>

    <link rel="stylesheet" href="http://laradock.io/stylesheets/application.css">
    <link rel="stylesheet" href="http://laradock.io/stylesheets/temporary.css">
    <link rel="stylesheet" href="http://laradock.io/stylesheets/palettes.css">
    <link rel="stylesheet" href="http://laradock.io/stylesheets/highlight/highlight.css">

    
    <link rel="stylesheet" href="//fonts.googleapis.com/css?family=Doctarine:400,700|Source&#43;Code&#43;Pro">
    <style>
      body, input {
        font-family: 'Doctarine', Helvetica, Arial, sans-serif;
      }
      pre, code {
        font-family: 'Source Code Pro', 'Courier New', 'Courier', monospace;
      }
    </style>

    
    <script src="http://laradock.io/javascripts/modernizr.js"></script>

    
  </head>
  <body class="palette-primary-deep-purple palette-accent-purple">


<div class="backdrop">
	<div class="backdrop-paper"></div>
</div>

<input class="toggle" type="checkbox" id="toggle-drawer">
<input class="toggle" type="checkbox" id="toggle-search">
<label class="toggle-button overlay" for="toggle-drawer"></label>

<header class="header">
	<nav aria-label="Header">
  <div class="bar default">
    <div class="button button-menu" role="button" aria-label="Menu">
      <label class="toggle-button icon icon-menu" for="toggle-drawer">
        <span></span>
      </label>
    </div>
    <div class="stretch">
      <div class="title">
          <b>Laradock</b> <span style="color: rgba(249, 245, 255, 0.63);"> / Getting Started</span>
      </div>
    </div>

    
    <div class="button button-github" role="button" aria-label="GitHub">
        <a style="padding: 0px; font-size:40px" href="https://github.com/laradock/laradock" title="@laradock/laradock on GitHub" target="_blank" class="toggle-button icon icon-github"></a>
    </div>
      <p style="font-size: 18px; padding: 8px">Github</p>
    
    
  </div>
  <div class="bar search">
    <div class="button button-close" role="button" aria-label="Close">
      <label class="toggle-button icon icon-back" for="toggle-search"></label>
    </div>
    <div class="stretch">
      <div class="field">
        <input class="query" type="text" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck>
      </div>
    </div>
    <div class="button button-reset" role="button" aria-label="Search">
      <button class="toggle-button icon icon-close" id="reset-search"></button>
    </div>
  </div>
</nav>

</header>

<main class="main">
	<div class="drawer">
		<nav aria-label="Navigation">
  
    
  <div class="scrollable">
    <div class="wrapper">
      

      <div class="toc">
        
        <ul>
          

<li>
  
    
<a  title="Introduction" href="http://laradock.io/introduction/">
	
	Introduction
</a>


</li>


<li>
  
    
<a class="current" title="Getting Started" href="http://laradock.io/getting-started/">
	
	Getting Started
</a>


<ul id="scrollspy">
</ul>


</li>


<li>
  
    
<a  title="Documentation" href="http://laradock.io/documentation/">
	
	Documentation
</a>


</li>


<li>
  
    
<a  title="Related Projects" href="http://laradock.io/related-projects/">
	
	Related Projects
</a>


</li>


<li>
  
    
<a  title="Help &amp; Questions" href="http://laradock.io/help/">
	
	Help &amp; Questions
</a>


</li>


<li>
  
    
<a  title="Contributing" href="http://laradock.io/contributing/">
	
	Contributing
</a>


</li>


<li>
  
    
<a  title="License" href="http://laradock.io/license/">
	
	License
</a>


</li>


        </ul>
        

        <ul>
          

        </ul>
        
      </div>
    </div>
  </div>
</nav>

	</div>

	<article class="article">
		<div class="wrapper">
			<h1>Getting Started </h1>

			
<h2 id="requirements">Requirements</h2>

<ul>
<li><a href="https://git-scm.com/downloads">Git</a></li>
<li><a href="https://www.docker.com/products/docker/">Docker</a> <code>&gt;= 1.12</code></li>
</ul>

<h2 id="installation">Installation</h2>

<p>Choose the setup the best suits your needs.</p>

<h4 id="a-setup-for-single-project">A) Setup for Single Project:</h4>

<p><em>(In case you want a Docker environment for each project)</em></p>

<h5 id="a-1-setup-environment-in-existing-project">A.1) Setup environment in existing Project:</h5>

<p><em>(In case you already have a project, and you want to setup an environment to run it)</em></p>

<p>1 - Clone this repository on your project root directory:</p>

<pre><code class="language-bash">git submodule add https://github.com/Laradock/laradock.git
</code></pre>

<p><em>Note 1: If you are not yet using Git for your PHP project, you can use <code>git clone https://github.com/Laradock/laradock.git</code> instead.</em></p>

<p><em>Note 2: To keep track of your LaraDock changes, between your projects and also keep LaraDock updated. <a href="#keep-tracking-LaraDock">Check this</a></em></p>

<p><em>Note 3: In this case the folder structure will be like this:</em></p>

<pre><code>- project1
	- laradock
- project2
	- laradock
</code></pre>

<h5 id="a-2-setup-environment-first-then-create-project">A.2) Setup environment first then create project:</h5>

<p><em>(In case you don&rsquo;t have a project, and you want to create your project inside the Docker environment)</em></p>

<p>1 - Clone this repository anywhere on your machine:</p>

<pre><code class="language-bash">git clone https://github.com/laradock/laradock.git
</code></pre>

<p>Note: In this case the folder structure will be like this:</p>

<pre><code>- projects
	- laradock
	- myProject
</code></pre>

<p>2 - Edit the <code>docker-compose.yml</code> file to map to your project directory once you have it (example: <code>- ../myProject:/var/www</code>).</p>

<p>3 - Stop and re-run your docker-compose command for the changes to take place.</p>

<pre><code>docker-compose stop &amp;&amp; docker-compose up -d XXXX YYYY ZZZZ ....
</code></pre>

<h4 id="b-setup-for-multiple-projects">B) Setup for Multiple Projects:</h4>

<p>1 - Clone this repository anywhere on your machine:</p>

<pre><code class="language-bash">git clone https://github.com/laradock/laradock.git
</code></pre>

<p>2 - Edit the <code>docker-compose.yml</code> file to map to your projects directories:</p>

<pre><code>    applications:
        image: tianon/true
        volumes:
            - ../project1/:/var/www/project1
            - ../project2/:/var/www/project2
</code></pre>

<p>3 - You can access all sites by visiting <code>http://localhost/project1/public</code> and <code>http://localhost/project2/public</code> but of course that&rsquo;s not very useful so let&rsquo;s setup NGINX quickly.</p>

<p>4 - Go to <code>nginx/sites</code> and copy <code>sample.conf.example</code> to <code>project1.conf</code> then to <code>project2.conf</code></p>

<p>5 - Open the <code>project1.conf</code> file and edit the <code>server_name</code> and the <code>root</code> as follow:</p>

<pre><code>    server_name project1.dev;
    root /var/www/project1/public;
</code></pre>

<p>Do the same for each project <code>project2.conf</code>, <code>project3.conf</code>,&hellip;</p>

<p>6 - Add the domains to the <strong>hosts</strong> files.</p>

<pre><code>127.0.0.1  project1.dev
</code></pre>

<p>7 - Create your project Databases. Right now you have to do it manually by entering your DB container, until we automate it soon.</p>

<h2 id="usage">Usage</h2>

<p><strong>Read Before starting:</strong></p>

<p>If you are using <strong>Docker Toolbox</strong> (VM), do one of the following:</p>

<ul>
<li>Upgrade to Docker <a href="https://www.docker.com/products/docker">Native</a> for Mac/Windows (Recommended). Check out <a href="#upgrading-laradock">Upgrading LaraDock</a></li>
<li>Use LaraDock v3.* (Visit the <code>LaraDock-ToolBox</code> <a href="https://github.com/laradock/laradock/tree/LaraDock-ToolBox">Branch</a>).</li>
</ul>

<p><br></p>

<blockquote>
<p><strong>Warning:</strong> If you used an older version of LaraDock it&rsquo;s highly recommended to rebuild the containers you need to use <a href="#Build-Re-build-Containers">see how you rebuild a container</a> in order to prevent errors as much as possible.</p>
</blockquote>

<p><br></p>

<p>1 - Run Containers: <em>(Make sure you are in the <code>laradock</code> folder before running the <code>docker-compose</code> commands).</em></p>

<p><strong>Example:</strong> Running NGINX and MySQL:</p>

<pre><code class="language-bash">docker-compose up -d nginx mysql
</code></pre>

<p><strong>Note</strong>: The <code>workspace</code> and <code>php-fpm</code> will run automatically in most of the cases, so no need to specify them in the <code>up</code> command. If you couldn&rsquo;t find them running then you need specify them as follow: <code>docker-compose up -d nginx php-fpm mysql workspace</code>.</p>

<p>You can select your own combination of Containers form the list below:</p>

<p><code>nginx</code>, <code>hhvm</code>, <code>php-fpm</code>, <code>mysql</code>, <code>redis</code>, <code>postgres</code>, <code>mariadb</code>, <code>neo4j</code>, <code>mongo</code>, <code>apache2</code>, <code>caddy</code>, <code>memcached</code>, <code>beanstalkd</code>, <code>beanstalkd-console</code>, <code>rabbitmq</code>, <code>workspace</code>, <code>phpmyadmin</code>, <code>aerospike</code>, <code>pgadmin</code>, <code>elasticsearch</code>, <code>rethinkdb</code>.</p>

<p><br>
2 - Enter the Workspace container, to execute commands like (Artisan, Composer, PHPUnit, Gulp, &hellip;).</p>

<pre><code class="language-bash">docker-compose exec workspace bash
</code></pre>

<p>Alternatively, for Windows PowerShell users: execute the following command to enter any running container:</p>

<pre><code class="language-bash">docker exec -it {workspace-container-id} bash
</code></pre>

<p><strong>Note:</strong> You can add <code>--user=laradock</code> (example <code>docker-compose exec --user=laradock workspace bash</code>) to have files created as your host&rsquo;s user. (you can change the PUID (User id) and PGID (group id) variables from the <code>docker-compose.yml</code>).</p>

<p><br>
3 - Edit your project configurations.</p>

<p>Open your <code>.env</code> file and set the <code>DB_HOST</code> to <code>mysql</code>:</p>

<pre><code class="language-env">DB_HOST=mysql
</code></pre>

<p><em>If you want to use Laravel and you don&rsquo;t have it installed yet, see <a href="#Install-Laravel">How to Install Laravel in a Docker Container</a>.</em></p>

<p><br>
4 - Open your browser and visit your localhost address (<code>http://localhost/</code>).</p>

<p><br>
<strong>Debugging</strong>: if you are facing any problem here check the <a href="#debugging">Debugging</a> section.</p>

<p>If you need a special support. Contact me, more details in the <a href="#Help">Help &amp; Questions</a> section.</p>


			<aside class="copyright" role="note">
				
				Documentation built with
				<a href="https://www.gohugo.io" target="_blank">Hugo</a>
				using the
				<a href="http://github.com/digitalcraftsman/hugo-material-docs" target="_blank">Material</a> theme.
			</aside>

			<footer class="footer">
				

<nav class="pagination" aria-label="Footer">
  <div class="previous">
  
      <a href="http://laradock.io/introduction/" title="Introduction">
        <span class="direction">
          Previous
        </span>
        <div class="page">
          <div class="button button-previous" role="button" aria-label="Previous">
            <i class="icon icon-back"></i>
          </div>
          <div class="stretch">
            <div class="title">
              Introduction
            </div>
          </div>
        </div>
      </a>
  
  </div>

  <div class="next">
  
      <a href="http://laradock.io/documentation/" title="Documentation">
        <span class="direction">
          Next
        </span>
        <div class="page">
          <div class="stretch">
            <div class="title">
              Documentation
            </div>
          </div>
          <div class="button button-next" role="button" aria-label="Next">
            <i class="icon icon-forward"></i>
          </div>
        </div>
      </a>
  
  </div>
</nav>


			</footer>
		</div>
	</article>

	<div class="results" role="status" aria-live="polite">
		<div class="scrollable">
			<div class="wrapper">
				<div class="meta"></div>
				<div class="list"></div>
			</div>
		</div>
	</div>
</main>

    <script>
    
      var base_url = '';
      var repo_id  = '';
    
    </script>

    <script src="http://laradock.io/javascripts/application.js"></script>
    

    <script>
      /* Add headers to scrollspy */
      var headers   = document.getElementsByTagName("h2");
      var scrollspy = document.getElementById('scrollspy');

      if(scrollspy) {
        if(headers.length > 0) {
          for(var i = 0; i < headers.length; i++) {
            var li = document.createElement("li");
            li.setAttribute("class", "anchor");

            var a  = document.createElement("a");
            a.setAttribute("href", "#" + headers[i].id);
            a.setAttribute("title", headers[i].innerHTML);
            a.innerHTML = headers[i].innerHTML;

            li.appendChild(a)
            scrollspy.appendChild(li);
          }
        } else {
          scrollspy.parentElement.removeChild(scrollspy)
        }


        /* Add permanent link next to the headers */
        var headers = document.querySelectorAll("h1, h2, h3, h4, h5, h6");

        for(var i = 0; i < headers.length; i++) {
            var a = document.createElement("a");
            a.setAttribute("class", "headerlink");
            a.setAttribute("href", "#" + headers[i].id);
            a.setAttribute("title", "Permanent link")
            a.innerHTML = "#";
            headers[i].appendChild(a);
        }
      }
    </script>

    
      <script>
        (function(i,s,o,g,r,a,m){
          i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){(i[r].q=i[r].q||
          []).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;
          m.parentNode.insertBefore(a,m)
        })(window, document,
          'script', '//www.google-analytics.com/analytics.js', 'ga');
         
        ga('create', 'UA-37514928-9', 'auto');
        ga('set', 'anonymizeIp', true);
        ga('send', 'pageview');
         
        var buttons = document.querySelectorAll('a');
        Array.prototype.map.call(buttons, function(item) {
          if (item.host != document.location.host) {
            item.addEventListener('click', function() {
              var action = item.getAttribute('data-action') || 'follow';
              ga('send', 'event', 'outbound', action, item.href);
            });
          }
        });
         
        var query = document.querySelector('.query');
        query.addEventListener('blur', function() {
          if (this.value) {
            var path = document.location.pathname;
            ga('send', 'pageview', path + '?q=' + this.value);
          }
        });
      </script>
    

    <script src="//cdnjs.cloudflare.com/ajax/libs/highlight.js/9.8.0/highlight.min.js"></script>
    <script>hljs.initHighlightingOnLoad();</script>
  </body>
</html>