From 68b5b770c79bffaa430cbbd9026ead754ed8f122 Mon Sep 17 00:00:00 2001
From: Jean-Yves <7360784+docjyJ@users.noreply.github.com>
Date: Fri, 26 Jul 2024 17:39:36 +0200
Subject: [PATCH] Update readeMe

Signed-off-by: Jean-Yves <7360784+docjyJ@users.noreply.github.com>
---
 php/README.md | 41 ++++++++++++++++++++++++++++++++---------
 1 file changed, 32 insertions(+), 9 deletions(-)

diff --git a/php/README.md b/php/README.md
index ca6ede1d..70028349 100644
--- a/php/README.md
+++ b/php/README.md
@@ -4,29 +4,52 @@ This is the code for the PHP Docker controller.
 
 ## How to run
 
-Running this locally requires Docker Engine on the same machine. 
-If this is the case, just execute the following command:
+Running this locally requires :
+
+### 1. Install the development environment
+
+This project uses Composer as dependency management software. It is very similar to NPM.
+The command to install all dependencies is:
 
 ```bash
 composer install
-sudo SKIP_DOMAIN_VALIDATION=true composer run dev # sudo is required to access docker socket
 ```
 
-You can then access the web interface at `localhost:8080`.
+### 2. Access to docker socket
 
-If you have an error that says `Couldn't connect to server for http://127.0.0.1/v1.41/networks/create` makes sure a `nextcloud-aio-mastercontainer` is running.
-You can start it with the following command:
+The `root` user has all privileges including access to the Docker socket. 
+But **it is not recommended to launch the local instance with full privileges**, consider the docker group for docker access without being `root`.
+See https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user
+
+### 3. Run a `nextcloud-aio-mastercontainer` container
+
+This application manages containers, including its own container.
+So you need to run a `nextcloud-aio-mastercontainer` container for the application to work properly.
+
+Here is a command to quickly launch a container :
 
 ```bash
-sudo docker run \
+docker run \
 --rm \
 --name nextcloud-aio-mastercontainer \
 --volume nextcloud_aio_mastercontainer:/mnt/docker-aio-config \
---volume /var/run/docker.sock:/var/run/docker.sock:ro \
 nextcloud/all-in-one:latest
 ```
 
-## Commands
+### 4. Start your server
+
+With this command you will launch the server:
+
+```bash
+# Make sure to launch this command with a user having access to the docker socket.
+SKIP_DOMAIN_VALIDATION=true composer run dev
+```
+
+You can then access the web interface at http://localhost:8080.
+
+Note: You can restart the server by preceding the command with other environment variables.
+
+## Composer routine
 
 | Command                                 | Description                            |
 |-----------------------------------------|----------------------------------------|