Install using Docker.

Docker installation for development only, do not use it on production environment.

• Open .env file and change:

  • DB_HOST=127.0.0.1 to DB_HOST=mysql
  • DB_USERNAME= to DB_USERNAME=botble (or any username you want)
  • DB_PASSWORD= to DB_PASSWORD=botble (or any password you want)

• Run docker compose pull to pull the latest images.

• Run docker compose up -d to start the services.

• Run docker compose exec -u www app composer install to install the dependencies (or update command).

• Run docker compose exec -u www app php artisan migrate to create the database structure.

• Run docker compose exec -u www app php artisan db:seed if you need our sample data.

• Run docker compose exec -u www app php artisan cms:publish:assets to publish assets.

• Open http://localhost to see the homepage (or http://localhost:{YOUR_PORT}).

• Admin panel URL: http://localhost/admin

• Default admin account:

  • If you use our sample data, the default admin account is admin with the password 12345678.
  • If not, run docker compose exec -u www app php artisan cms:user:create to create an admin user.

• Run docker compose down to stop the services.

• Some useful commands:

  • docker compose exec -u www app sh access to the container.
  • docker compose exec -u www app php <...> php command.
  • docker compose exec -u www app php artisan <...> artisan command.
  • docker compose exec -u www app composer <...> composer command.

TIP

If you have any issues with the docker compose command, try to use docker-compose instead. Somethings ports are already in use, you can change the port in the docker-compose.yml file or use environment variables to change the port (e.g: APP_PORT=8080).

Issues

Service is not running issue.

If you encounter the "service 'app' is not running" error, try to run docker compose down, then open file docker-compose.yml and change the service laravel.test to app in the services section and run docker compose up -d again.

Rebuild images

Run docker-compose down --volumes and then sail up --build to rebuild the images.