1 files changed, 46 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..658de33
--- /dev/null
+++ b/README.md
@@ -0,0 +1,46 @@
+# cgit material docker
+
+Dockerized cgit with a responsive Material Design theme.
+
+## Quick Start
+
+Run the container using the following command:
+
+```bash
+docker run -d -p 80:80 igorechek06/cgit-material-docker
+```
+
+## Configuration and Volumes
+
+You can map local directories to the following paths inside the container to customize the instance.
+
+### /app/repos
+
+This is the recommended directory to store your git repositories.
+
+### /app/etc/cgitrc
+
+The main configuration file. It follows the standard `cgitrc` syntax.
+
+### /app/include
+
+Contains HTML fragments included in the pages.
+
+- **head.html**: Used by the `head-include` setting.
+- You can also place files here for the `header` or `footer` settings defined in `cgitrc`.
+
+### /app/filters
+
+Contains the original cgit filters and two custom filters required for the Material theme. You can add your own custom filter scripts to this directory.
+
+### /app/www/static/
+
+Used for storing static assets such as images.
+
+- **Note:** When referencing these files in `cgitrc`, write the path relative to `/app/www/`.
+
+### /app/about/
+
+Used to store specific Markdown files for repository descriptions.
+
+- **Usage:** Set `repo.readme=/app/about/filename.md` in your config.