update version and add instructions

Author: giuseppemorelli

CHANGELOG.md

@@ -1,6 +1,8 @@
 # Changelog
 
-## WIP
+## 0.1.5
+
+### Added
 - add new service for golang
 - add new service for mailpit
 

README.md

@@ -10,6 +10,59 @@
 Simple docker-compose.yml file with pre-configured services.  
 Can create multiple environment, start with `local`
 
-How-to: work in progress
-
 Inspired by [Devilbox](http://devilbox.org/)
+
+---
+
+## How to Use the Docker DEV Box
+
+### 1. Prerequisites
+
+- Install [Docker](https://docs.docker.com/get-docker/) and [Docker Compose](https://docs.docker.com/compose/install/) on your system.
+
+### 2. Clone the Repository
+
+```sh
+git clone https://github.com/giuseppemorelli/docker-devbox.git
+cd docker-devbox
+```
+
+### 3. Configure Your Environment
+
+- Copy the example environment file and adjust as needed:
+  ```sh
+  cp local/env.dist local/.env
+  # Edit local/.env to match your requirements
+  ```
+  
+- Uncomment the services you want to use in the `docker-compose.yml` file.  
+  For example, to enable MySQL, uncomment the following lines:
+  ```yaml
+  mysql:
+    container_name: ${COMPOSE_PROJECT_NAME}_${MYSQL_SERVER_NAME}
+    image: ${MYSQL_SERVER}
+
+    environment:
+      MYSQL_ROOT_PASSWORD: "docker"
+      # for mysql 8 comment user and password user, need to create via script only for legacy project
+      MYSQL_USER: "local"
+      MYSQL_PASSWORD: "local"
+    # ....
+  ```
+
+### 4. Start the Services
+
+- From the environment root, run:
+  ```sh
+  cd local
+  docker-compose up -d
+  ```
+  
+### 5. Stopping and Cleaning Up
+
+- To stop the services:
+  ```sh
+  cd local
+  docker-compose down -v
+  ```
+

local/docker-compose.yml

@@ -6,8 +6,6 @@
 ##   $ cp env-example .env
 ##
 
-version: '3'
-
 ################################################################################
 # SERVICES
 ################################################################################

local/env.dist

@@ -53,9 +53,9 @@ ENVIRONMENT=local
 ################################################################################
 
 WEB_SERVER=giuseppemorelli/devbox-apache-php:8.2
-PHP_VERSION=7.3
-NODEJS_SERVER=node:14
-MYSQL_SERVER=mysql:5.7
+PHP_VERSION=8.2
+NODEJS_SERVER=node:18
+MYSQL_SERVER=mysql:8
 REDIS_SERVER=redis:latest
 REDIS_COMMANDER_SERVER=rediscommander/redis-commander
 PHPMYADMIN_SERVICE=phpmyadmin/phpmyadmin

local/provision/bin/db_tasks.sh

@@ -4,7 +4,7 @@ echo "CREATE DATABASE"
 # mysql -u root -pdocker -e "CREATE DATABASE mydatabase"
 echo "SETTING UP local USER"
 # for mysql < 8
-mysql -u root -pdocker -e "REVOKE ALL PRIVILEGES ON *.* FROM 'local'@'%'; GRANT ALL PRIVILEGES ON *.* TO 'local'@'%' REQUIRE NONE WITH GRANT OPTION MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0;"
+# mysql -u root -pdocker -e "REVOKE ALL PRIVILEGES ON *.* FROM 'local'@'%'; GRANT ALL PRIVILEGES ON *.* TO 'local'@'%' REQUIRE NONE WITH GRANT OPTION MAX_QUERIES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_USER_CONNECTIONS 0;"
 # for mysql >= 8
-##  mysql -u root -pdocker -e "CREATE USER 'local'@'%' IDENTIFIED WITH mysql_native_password BY 'local';"
-# mysql -u root -pdocker -e "GRANT ALL PRIVILEGES ON *.* TO 'local'@'%' WITH GRANT OPTION;"
+mysql -u root -pdocker -e "CREATE USER 'local'@'%' IDENTIFIED WITH mysql_native_password BY 'local';"
+mysql -u root -pdocker -e "GRANT ALL PRIVILEGES ON *.* TO 'local'@'%' WITH GRANT OPTION;"