diff --git a/data/README.md b/data/README.md
new file mode 100644
index 0000000..fd9feb7
--- /dev/null
+++ b/data/README.md
@@ -0,0 +1,9 @@
+# Gitea Data directory
+
+This directory is intended to store all the data files for Gitea, including repositories, configuration files, logs, and other necessary data.
+
+## Structure
+
+./pkgs
+./data
+
diff --git a/docker-compose.yml b/docker-compose.yml
index 8b659c8..2eecb53 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -1,20 +1,25 @@
 services:
   runner:
     image: docker.io/gitea/act_runner:nightly
+    
     environment:
-      CONFIG_FILE: /config.yaml
-      GITEA_INSTANCE_URL: http://gitea:3000/
-      GITEA_RUNNER_REGISTRATION_TOKEN: znrn4iy94Zx2OWwQx4UHkdWMOH6ISBQ6NVfdkf4K
+      CONFIG_FILE: /config.yaml               # <-- Path to the runner configuration file inside the container
+      GITEA_INSTANCE_URL: http://gitea:3000/  # <-- Use the internal Docker network URL
+      GITEA_RUNNER_REGISTRATION_TOKEN: asdasd # <-- REPLACE WITH YOUR REGISTRATION TOKEN
       GITEA_RUNNER_NAME: FastFlaskRunner
+    
     volumes:
-      - ./config.yaml:/config.yaml
-      - /prod/pkgs:/prod/pkgs
-      - /prod/data:/prod/data
-      - /prod/develop/data:/develop/data
-      - /var/run/docker.sock:/var/run/docker.sock
+      - ./config/runner.yaml:/config.yaml # <-- Mount for runner configuration
+      - ./data/prod/pkgs:/prod/pkgs  # <-- Mount for production packages
+      - ./data/prod/data:/prod/data  # <-- Mount for production data
+      - ./data/develop:/develop/data # <-- Mount for development data
+      - /var/run/docker.sock:/var/run/docker.sock # <-- Mount Docker socket for Docker-in-Docker functionality (DoNotChange)
+    
     depends_on:
       - gitea
+    
     restart: always
+
     networks:
       - fast-services
 
@@ -23,19 +28,19 @@ services:
     container_name: gitea
     restart: always
     environment:
-      - ROOT_URL=https://git.nxs.solutions/
-    # Map container ports to host ports (Web UI: 3000, SSH: 2222)
+      - ROOT_URL=https://git.nxs.solutions/ # <-- Change to your Gitea URL either Domain or IP with protocol
     ports:
-      - "2222:22" 
+      - "2222:22" # <-- SSH access for Git operations (Change if needed to your preferred port)
+      # - "3000:3000"  # Uncomment if you want to expose Gitea web interface directly (needed if not rooted behind a reverse proxy)
+
     volumes:
       # Persistent storage for Gitea data, configuration, repositories, etc.
       # Maps a named volume 'gitea_data' to the container's /data directory.
       - ./data:/data 
-      # Timezone settings for consistent timekeeping
-      - /etc/timezone:/etc/timezone:ro
-      - /etc/localtime:/etc/localtime:ro
-      - /srv/git:/data/host_repos:ro  # <--- ADD THIS LINE
-      - ./logs/:/data/gitea/log/:rw
+      - /etc/timezone:/etc/timezone:ro    # <--- Timezone settings
+      - /etc/localtime:/etc/localtime:ro  # <--- Timezone settings
+      - ./data/git:/data/host_repos:ro    # <--- Mount for Git repositories
+      - ./logs/:/data/gitea/log/:rw       # <--- Mount for Gitea logs (neccessary for debugging and fail2ban)
 
     networks:
       - fast-services
@@ -46,7 +51,6 @@ services:
       timeout: 10s
       retries: 3
 
-
 networks:
   fast-services:
     external: true