diff --git a/README.md b/README.md
index e69de29..d9fc113 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,3 @@
+# A collection of docker containers associated with Magpie project
+
+For more details look into folders
diff --git a/pica-apache/README.md b/pica-apache/README.md
new file mode 100644
index 0000000..ab4685c
--- /dev/null
+++ b/pica-apache/README.md
@@ -0,0 +1,9 @@
+# Pica with apache composition
+
+A ready to use pica + webserver composition
+
+### Running
+```
+$ cd <this directory>
+$ docker compose up
+```
diff --git a/pica-apache/docker-compose.yml b/pica-apache/docker-compose.yml
index a48381b..dfa16f0 100644
--- a/pica-apache/docker-compose.yml
+++ b/pica-apache/docker-compose.yml
@@ -14,5 +14,5 @@ services:
         links:
             - pica
 volumes:
-  picarun:
+    picarun:
 
diff --git a/pica-environment/README.md b/pica-environment/README.md
new file mode 100644
index 0000000..d395786
--- /dev/null
+++ b/pica-environment/README.md
@@ -0,0 +1,8 @@
+# Pica environment container
+
+A minimal environment to launch pica service (pica itself is not included)
+
+### Running
+```
+$ docker run --rm thebluestbird/pica-environment:latest
+```
diff --git a/pica-standalone/README.md b/pica-standalone/README.md
new file mode 100644
index 0000000..81011b6
--- /dev/null
+++ b/pica-standalone/README.md
@@ -0,0 +1,17 @@
+# Pica standalone container
+
+A minimal pica distribution container, has environment to run pica and pica itself (no webserver included)
+
+### Running
+This container creates a unix socket `/run/pica/pica.sock`. I expect you to forward there fcgi requests from webserver.
+
+The simplest run is like this
+```
+$ docker run --rm thebluestbird/pica-standalone:latest
+```
+
+If you want the socket to be created somewhere outside of the container so you can operate it run it like so:
+```
+$ docker run --rm -v .:/run/pica thebluestbird/pica-standalone:latest
+```
+This action will bind current directory to container `/run/pica`, so the container will create a socket in your current directory. If you want a dedicated place for the socket to be created - just replace `.` after `-v` with the desired path.