diff --git a/localstack/README.md b/localstack/README.md
new file mode 100644
index 0000000..8c4900d
--- /dev/null
+++ b/localstack/README.md
@@ -0,0 +1,63 @@
+# LocalStack Configuration
+
+LocalStack is a local sandbox of aws environment for testing Terraform Iac and other useful things without concern about billings & payments
+
+## Requirements
+
+first of all we need python & pip:
+
+```bash
+sudo pacman -S python
+```
+
+```bash
+curl -sS https://bootstrap.pypa.io/get-pip.py | python
+python -m pip install --upgrade pip
+```
+
+we need localstack python package:
+
+```bash
+pip install localstack
+```
+
+This installs the ```localstack-cli``` which is used to run the Docker image that hosts the LocalStack runtime.
+
+## Runing
+
+firstly, we need localstack container invoked:
+
+```bash
+docker-compose up -d
+```
+
+right now we have to start localstack on host (not in container):
+
+```bash
+localstack start -d
+```
+
+it will get output like that:
+
+```bash
+     __                     _______ __             __
+    / /   ____  _________ _/ / ___// /_____ ______/ /__
+   / /   / __ \/ ___/ __ `/ /\__ \/ __/ __ `/ ___/ //_/
+  / /___/ /_/ / /__/ /_/ / /___/ / /_/ /_/ / /__/ ,<
+ /_____/\____/\___/\__,_/_//____/\__/\__,_/\___/_/|_|
+
+ 💻 LocalStack CLI 1.4.0
+
+[20:22:20] starting LocalStack in Docker mode 🐳
+           preparing environment
+LocalStack container named "localstack_main" is already running 
+```
+
+at last we can check services status:
+
+```bash
+localstack status services
+```
+
+more information on: https://github.com/localstack/localstack
+
diff --git a/localstack/docker-compose.yml b/localstack/docker-compose.yml
new file mode 100644
index 0000000..164c22a
--- /dev/null
+++ b/localstack/docker-compose.yml
@@ -0,0 +1,16 @@
+version: "3.9"
+
+services:
+  localstack:
+    container_name: "${LOCALSTACK_DOCKER_NAME-localstack_main}"
+    image: localstack/localstack:1.4
+    ports:
+      - "127.0.0.1:4566:4566"            # LocalStack Gateway
+      - "127.0.0.1:4510-4559:4510-4559"  # external services port range
+    environment:
+      DEBUG: ${DEBUG-}
+      LAMBDA_EXECUTOR: ${LAMBDA_EXECUTOR-}
+      DOCKER_HOST: unix:///var/run/docker.sock
+    volumes:
+      - ./volumes/localstack/lib:/var/lib/localstack
+      - /var/run/docker.sock:/var/run/docker.sock
\ No newline at end of file