How To Setup Laravel In Docker Container
Laravel Docker Tutorial
How To Setup Laravel In Docker Container environment locally on your machine. Laradock is well-known package in the Laravel community. I will use Laradoc library to show you how to prepare Docker Container and run the laravel application in it. Docker is different from Homestead. Homestead creates a virtual machine while Docker, on the other hand, is pretty much the same as Vagrant, it also gives you the complete development environment but on Virtual Containers instead of Virtual Machine. Since running a virtual Container is much faster than running a full Virtual Machine, LaraDock is much quicker than Homestead. Homestead is just a command line tool that helps you to initialize and to boot a Virtual Machine via Vagrant. Where you SSH into that machine and start coding.
- 1 What is Docker Container
- 2 Laradock
- 3 Setup Laravel In Docker Container
- 4 Quick Note
- 5 Other installation Softwares
- 6 Step 1: Install The Laravel 5.6 in your directory.
- 7 Step 2: Clone the Laradoc repository.
- 8 Step 3: Rename the files.
- 9 Step 4: Run your containers.
What is Docker Container
Docker is a computer program that performs operating-system-level virtualization also known as containerization. Docker, Inc had developed it. Docker is an open platform for developers and sysadmins to build, ship, and run distributed applications, whether on laptops, data center VMs, or the cloud.
Container image is the lightweight, stand-alone, executable package of a piece of software that includes everything you needed to run it: code, runtime, system tools, system libraries, settings.
Docker is the tool designed to make it easier to create, deploy, and run applications by using the containers.
Containers allow the developer to package up an application with all of the parts it needs, such as libraries and other dependencies, and ship it all out as one package.
Docker is an open-source project for automating the deployment of applications as portable, self-sufficient containers that can run on the cloud or on-premises.
Laradoc is a full PHP development environment for Docker.
It includes pre-packaged Docker Images, all pre-configured to provide an excellent PHP development environment.
Setup Laravel In Docker Container
First, we will install the Docker on mac, and then we will clone the repository of Laradoc and start configuring it. So let us do that first.
Install and run Docker for Mac.
For download Docker on mac, please use this link Docker Community Edition (CE) to install the stable version of docker. The Docker for Mac install package includes everything you need to run Docker on a Mac. This topic describes pre-install considerations, and how to download and install Docker for Mac.
Now, after installation, Double-click Docker.dmg to open the installer, then drag Moby, the whale to the Applications folder.
Okay, next is double click to that whale icon on the applications and it will open the installer then it will start on the right-hand side corner. You can see the Moby whale icon there.
If you have not created your docker id then you should create one, it is free. Now, verify the docker’s version using the following command.
My version is: Docker version 18.03.0-ce, build 0520e24
If you are using Laravel Valet, then please stop the Laravel Valet because otherwise valet’s nginx and docker’s nginx server will crash at the same port. So before the beginning of the installation process, please close all the nginx and mysql servers. You can stop it using the following command.
Other installation Softwares
We will install the different containers.
Step 1: Install The Laravel 5.6 in your directory.
You can install the Laravel in your regular project directory using the following command.
composer create-project laravel/laravel doc --prefer-dist
Now, go into the project folder.
Open the folder in Visual Studio Code using the following command. You can choose your favorite editor.
Now, we need to change the database settings in the .env file.
DB_CONNECTION=mysql DB_HOST=mysql DB_PORT=3306 DB_DATABASE=doc DB_USERNAME=root DB_PASSWORD=root
Put your database name. Note that, here we are using the host as mysql and in general scenario, we are taking host as localhost or 127.0.0.1. Just put the above snippet inside the .env file, and you are good to go.
Step 2: Clone the Laradoc repository.
Clone the following repository in the Laravel project. Remeber, you have to clone the repo. Inside the Laravel project and in our case it is doc folder.
git clone https://github.com/Laradock/laradock.git
It will create the folder called laradock. Now, your project structure looks like this.
Go into the laradock folder.
Step 3: Rename the files.
cp env-example .env
Step 4: Run your containers.
Type the following command in your terminal.
docker-compose up -d nginx mysql phpmyadmin redis workspace
If it is your first time, then it will take 15-20 minutes to install all the containers one by one and create the docker container environment.
It will start the nginx server, mysql server, phpmyadmin.
If it you face any issues related to yarn then merely install the yarn and rerun the docker-compose command.
You can list your running containers using the following command.
Also, you can restart your containers using the following command.
docker restart $(docker ps -q)
You can kill all the containers using the following command.
docker kill $(docker ps -a -q)
You can stop all the containers using the following command.
docker stop $(docker ps -aq)
Now, again restart your container, if you have stopped your container.
docker-compose up -d nginx mysql phpmyadmin
Switch to the browser and go to the following URL: http://localhost
You can see that our Laravel 5.6 is running on that local server. Yikes!! We are now running the Laravel inside the Docker Container.
We can access the phpMyAdmin at 8080 port on the browser. http://localhost:8080
It will open up the login page of phpmyadmin and remember, your server is mysql, the username is root, and password is root.
Create the database, whichever the name, you have written inside the .env file.
Now, you can access the whole laravel project directory using the command.
docker-compose exec workspace bash
Now, go into that project folder, which is a doc. It seems to be weird because we are already inside the doc >> laradoc. But after the above command, you still need to go doc. It is like, we are connected to the remote server, but the reality is that, we are on our local project. So it seems like, we have created a virtual environment for laravel, but in reality, we have just created small containers. That is why Docker is fast then Homestead. Now, go into the doc directory.
Now, type the following command to check the folders in this directory.
You can see that the structure is similar to Laravel structure. So we are at the root of our project, now migrate the schema to the database using the following command.
php artisan migrate
If you can migrate it correctly then, all of your configurations are working correctly, and you have installed Laravel successfully on Docker.
If you get any error, please verify your mysql server, database name, username, and password.
So, we have successfully installed Laravel on Docker. So our How To Setup Laravel In Docker Container Tutorial is over. Thanks for taking. Hope you like it. Comments are always welcome.