<h2 id="heading-introduction">Introduction</h2>
<p>Build a simple Laravel development environment with docker-compose. Compatible with Windows(WSL2), macOS(M1) and Linux.</p>
<h2 id="heading-usage">Usage</h2>
<h3 id="heading-laravel-install">Laravel install</h3>
<ol>
<li><p>Click <a target="_blank" href="https://github.com/ucan-lab/docker-laravel/generate">Use this template</a></p>
</li>
<li><p>Git clone &amp; change directory</p>
</li>
<li><p>Execute the following command</p>
</li>
</ol>
<pre><code class="lang-apache"><span class="hljs-attribute">make</span> create-project

<span class="hljs-comment"># or...</span>

<span class="hljs-attribute">mkdir</span> -p src
<span class="hljs-attribute">docker</span> compose build
<span class="hljs-attribute">docker</span> compose up -d
<span class="hljs-attribute">docker</span> compose exec app composer create-project --prefer-dist laravel/laravel .
<span class="hljs-attribute">docker</span> compose exec app php artisan key:generate
<span class="hljs-attribute">docker</span> compose exec app php artisan storage:link
<span class="hljs-attribute">docker</span> compose exec app chmod -R <span class="hljs-number">777</span> storage bootstrap/cache
<span class="hljs-attribute">docker</span> compose exec app php artisan migrate
</code></pre>
<p><a target="_blank" href="http://localhost">http://localhost</a></p>
<h3 id="heading-laravel-setup">Laravel setup</h3>
<ol>
<li><p>Git clone &amp; change directory</p>
</li>
<li><p>Execute the following command</p>
</li>
</ol>
<pre><code class="lang-apache"><span class="hljs-attribute">make</span> install
</code></pre>
<p><a target="_blank" href="http://localhost">http://localhost</a></p>
<h2 id="heading-tips">Tips</h2>
<ul>
<li><p>Read this <a target="_blank" href="https://github.com/ucan-lab/docker-laravel/blob/main/Makefile">Makefile</a>.</p>
</li>
<li><p>Read this <a target="_blank" href="https://github.com/ucan-lab/docker-laravel/wiki">Wiki</a>.</p>
</li>
</ul>
<h2 id="heading-container-structures">Container structures</h2>
<pre><code class="lang-plaintext">├── app
├── web
└── db
</code></pre>
<h3 id="heading-app-container">app container</h3>
<ul>
<li><p>Base image</p>
<ul>
<li><p><a target="_blank" href="https://hub.docker.com/_/php">php</a>:8.2-fpm-bullseye</p>
</li>
<li><p><a target="_blank" href="https://hub.docker.com/_/composer">composer</a>:2.6</p>
</li>
</ul>
</li>
</ul>
<h3 id="heading-web-container">web container</h3>
<ul>
<li><p>Base image</p>
<ul>
<li><a target="_blank" href="https://hub.docker.com/_/nginx">nginx</a>:1.25</li>
</ul>
</li>
</ul>
<h3 id="heading-db-container">db container</h3>
<ul>
<li><p>Base image</p>
<ul>
<li><a target="_blank" href="https://hub.docker.com/r/mysql/mysql-server">mysql/mysql-server</a>:8.0</li>
</ul>
</li>
</ul>
<h3 id="heading-mailpit-container">mailpit container</h3>
<ul>
<li><p>Base image</p>
<ul>
<li><a target="_blank" href="https://hub.docker.com/r/axllent/mailpit">axllent/mailpit</a></li>
</ul>
</li>
</ul>
<p>Source:</p>
<div class="embed-wrapper"><div class="embed-loading"><div class="loadingRow"></div><div class="loadingRow"></div></div><a class="embed-card" href="https://github.com/ucan-lab/docker-laravel">https://github.com/ucan-lab/docker-laravel</a></div>


## Introduction

Build a simple Laravel development environment with docker-compose. Compatible with Windows(WSL2), macOS(M1) and Linux.

## Usage

### Laravel install

1. Click [Use this template](https://github.com/ucan-lab/docker-laravel/generate)
    
2. Git clone & change directory
    
3. Execute the following command
    

```apache
make create-project

# or...

mkdir -p src
docker compose build
docker compose up -d
docker compose exec app composer create-project --prefer-dist laravel/laravel .
docker compose exec app php artisan key:generate
docker compose exec app php artisan storage:link
docker compose exec app chmod -R 777 storage bootstrap/cache
docker compose exec app php artisan migrate
```

[http://localhost](http://localhost)

### Laravel setup

1. Git clone & change directory
    
2. Execute the following command
    

```apache
make install
```

[http://localhost](http://localhost)

## Tips

* Read this [Makefile](https://github.com/ucan-lab/docker-laravel/blob/main/Makefile).
    
* Read this [Wiki](https://github.com/ucan-lab/docker-laravel/wiki).
    

## Container structures

```plaintext
├── app
├── web
└── db
```

### app container

* Base image
    
    * [php](https://hub.docker.com/_/php):8.2-fpm-bullseye
        
    * [composer](https://hub.docker.com/_/composer):2.6
        

### web container

* Base image
    
    * [nginx](https://hub.docker.com/_/nginx):1.25
        

### db container

* Base image
    
    * [mysql/mysql-server](https://hub.docker.com/r/mysql/mysql-server):8.0
        

### mailpit container

* Base image
    
    * [axllent/mailpit](https://hub.docker.com/r/axllent/mailpit)
        

Source:

%[https://github.com/ucan-lab/docker-laravel]

Build a simple Laravel development environment with docker-compose. Compatible with Windows(WSL2), macOS(M1) and Linux.

Build a simple Laravel development environment with docker-compose

A passionate full-stack developer from VIETNAM.


"Exploring Technology with David Nguyen" - Join me on a tech odyssey as we delve into the latest advancements, coding wonders, and digital frontiers. Let's embrace the tech world together!