In just 3 simple steps, you can use Kool CLI's
kool create command to start a new Laravel application running in a local Docker environment. Kool is an open source dev tool that makes using Docker for local development a lot easier.
Before you start, if you haven't done so already, you need to install Docker and Kool CLI.
$ kool create laravel my-project
This command may take a minute or two to complete while Composer downloads Laravel's vendor dependencies. After installing Laravel,
kool create automatically runs the
kool preset laravel command, which helps you set up your project's development environment using an interactive wizard.
? What app service do you want to use [Use arrows to move, type to filter] > PHP 8.0 PHP 7.4
? What database service do you want to use [Use arrows to move, type to filter] > MySQL 8.0 MySQL 5.7 MariaDB 10.5 PostgreSQL 13.0 none
? What cache service do you want to use [Use arrows to move, type to filter] > Redis 6.0 Memcached 1.6 none
After selecting your preferences, the latest version of Laravel will be installed and ready for you in your
my-project folder, along with your new
Move into your new Laravel project:
$ cd my-project
kool preset command auto-generated the following configuration files and added them to your project, which you can modify and extend.
Next, we need to make a few tweaks to the default .env.example file that ships with Laravel in order to match the services in your docker-compose.yml file. For example, we need to change the hosts from localhost to the appropriate service container name, which are accessible from within Docker.
MySQL 5.7 and 8.0 / MariaDB 10.5
-DB_CONNECTION=mysql +DB_CONNECTION=pgsql -DB_HOST=127.0.0.1 +DB_HOST=database -DB_PORT=3306 +DB_PORT=5432
Now, spin up your local environment for the first time using the
setup script in your kool.yml file:
$ kool run setup
Note: if you're running this command for the first time, Docker may need to download all the container images that are being used, which can take a few minutes, depending on your internet connection.
kool run setup has finished, you can access your new Laravel app at http://localhost.
$ kool run setup Creating network "my-project_kool_local" with the default driver Creating volume "my-project_database" with default driver Creating volume "my-project_cache" with default driver Creating my-project_cache_1 ... done Creating my-project_app_1 ... done Creating my-project_database_1 ... done
- Read the docs for our Laravel Preset to learn more about using Kool with Laravel.
- Go to kool.dev to learn more about the Kool open source project.
Kool is a CLI tool that brings the complexities of modern software development environments down to earth - making these environments lightweight, fast and reproducible. It reduces the complexity and learning curve of Docker and Docker Compose for local environments, and offers a simplified interface for using Kubernetes to deploy staging and production environments to the cloud.
Kool gets your local development environment up and running easily and quickly, so you have more time to build a great application. When the time is right, you can then use Kool Cloud to deploy and share your work with the world!
Kool is suitable for solo developers and teams of all sizes. It provides a hassle-free way to handle the Docker basics and immediately start using containers for development, while simultaneously guaranteeing no loss of control over more specialized Docker environments.
Requirements: Kool is…