5.6 KiB
| title | type | weight |
|---|---|---|
| Getting Started | index | 2 |
Requirements
Installation
Choose the setup the best suits your needs.
A) Setup for Single Project
(Follow these steps if you want a separate Docker environment for each project)
A.1) Already have a PHP project:
(Follow these steps if you already have a PHP project, and all you need is an environment to run it)
1 - Clone laradock on your project root directory:
git submodule add https://github.com/Laradock/laradock.git
Notes:
-
If you are not using Git yet for your project, you can use
git cloneinstead ofgit submodule. -
Note 2: To keep track of your Laradock changes, between your projects and also keep Laradock updated. Check this
Your folder structure should look like this:
+ project-a
+ laradock-a
+ project-b
+ laradock-b
(It's important to rename the folders differently in each project)
A.2) Don't have a PHP project yet:
(Follow these steps if you don't have a PHP project yet, and you need an environment to create the project)
1 - Clone this repository anywhere on your machine:
git clone https://github.com/laradock/laradock.git
Your folder structure should look like this:
+ laradock
+ project-z
2 - Edit your web server sites configuration.
In case of NGINX: open nginx/sites/default.conf and change the root from /var/www/public to /var/www/{my-project-folder-name}/public.
Or you can keep default.conf as it is, and create a separate config my-site.conf file for it.
In case of Apache: :P
3 - Run your docker-compose up command and you're ready to go.
Note: if you already had your containers up, you might need to take them down first and rebuild them for the changes to take effect.
B) Setup for Multiple Projects:
(Follow these steps if you want a single Docker environment for all your project)
1 - Clone this repository anywhere on your machine (similar to Steps A.2. from above):
git clone https://github.com/laradock/laradock.git
Your folder structure should look like this:
+ laradock
+ project-1
+ project-2
2 - Go to nginx/sites and create config files to point to different project directory when visiting different domains.
Laradock by default includes project-1.conf and project-2.conf as working samples.
3 - change the default names project-n:
You can rename the config files, project folders and domains as you like, just make sure the root in the config files, is pointing to the correct project folder name.
4 - Add the domains to the hosts files.
127.0.0.1 project-1.dev
127.0.0.1 project-2.dev
5 - Visit http://project-1.dev/ and http://project-2.dev/.
Usage
Read Before starting:
If you are using Docker Toolbox (VM), do one of the following:
- Upgrade to Docker Native for Mac/Windows (Recommended). Check out Upgrading Laradock
- Use Laradock v3.* (Visit the
Laradock-ToolBoxBranch).
Warning: If you used an older version of Laradock it's highly recommended to rebuild the containers you need to use see how you rebuild a container in order to prevent as much errors as possible.
1 - Run Containers: (Make sure you are in the laradock folder before running the docker-compose commands).
Example: Running NGINX and MySQL:
docker-compose up -d nginx mysql
Note: The workspace and php-fpm will run automatically in most of the cases, so no need to specify them in the up command. If you couldn't find them running then you need specify them as follow: docker-compose up -d nginx php-fpm mysql workspace.
You can select your own combination of Containers form the list below:
nginx, hhvm, php-fpm, mysql, redis, postgres, mariadb, neo4j, mongo, apache2, caddy, memcached, beanstalkd, beanstalkd-console, rabbitmq, beanstalkd-console, workspace, phpmyadmin, aerospike, pgadmin, elasticsearch, rethinkdb, postgres-postgis, certbot, mailhog, minio and more...!
(Please note that sometimes we forget to update the docs, so check the docker-compose.yml file to see an updated list of all available containers).
2 - Enter the Workspace container, to execute commands like (Artisan, Composer, PHPUnit, Gulp, ...).
docker-compose exec workspace bash
Alternatively, for Windows PowerShell users: execute the following command to enter any running container:
docker exec -it {workspace-container-id} bash
Note: You can add --user=laradock to have files created as your host's user. Example:
docker-compose exec --user=laradock workspace bash
You can change the PUID (User id) and PGID (group id) variables from the docker-compose.yml or the .env)
3 - Edit your project configurations.
Open your .env file and set the DB_HOST to mysql:
DB_HOST=mysql
If you want to install Laravel as PHP project, see How to Install Laravel in a Docker Container.
4 - Open your browser and visit your localhost address `http://localhost/`.