diff --git a/docker_example/README.md b/docker_example/README.md
index 9e72dc645..9eadce1f3 100644
--- a/docker_example/README.md
+++ b/docker_example/README.md
@@ -1,9 +1,65 @@
-# LangFlow Docker Running
+# Running LangFlow with Docker
 
-```sh
-git clone git@github.com:logspace-ai/langflow.git
-cd langflow/docker_example
-docker compose up
-```
+This guide will help you get LangFlow up and running using Docker and Docker Compose.
 
-The web UI will be accessible on port [7860](http://localhost:7860/)
\ No newline at end of file
+## Prerequisites
+
+- Docker
+- Docker Compose
+
+## Steps
+
+1. Clone the LangFlow repository:
+
+   ```sh
+   git clone https://github.com/langflow-ai/langflow.git
+   ```
+
+2. Navigate to the `docker_example` directory:
+
+   ```sh
+   cd langflow/docker_example
+   ```
+
+3. Run the Docker Compose file:
+
+   ```sh
+   docker compose up
+   ```
+
+LangFlow will now be accessible at [http://localhost:7860/](http://localhost:7860/).
+
+## Docker Compose Configuration
+
+The Docker Compose configuration spins up two services: `langflow` and `postgres`.
+
+### LangFlow Service
+
+The `langflow` service uses the `logspace/langflow:latest` Docker image and exposes port 7860. It depends on the `postgres` service.
+
+Environment variables:
+
+- `LANGFLOW_DATABASE_URL`: The connection string for the PostgreSQL database.
+- `LANGFLOW_CONFIG_DIR`: The directory where LangFlow stores logs, file storage, monitor data, and secret keys.
+
+Volumes:
+
+- `langflow-data`: This volume is mapped to `/var/lib/langflow` in the container.
+
+### PostgreSQL Service
+
+The `postgres` service uses the `postgres:16` Docker image and exposes port 5432.
+
+Environment variables:
+
+- `POSTGRES_USER`: The username for the PostgreSQL database.
+- `POSTGRES_PASSWORD`: The password for the PostgreSQL database.
+- `POSTGRES_DB`: The name of the PostgreSQL database.
+
+Volumes:
+
+- `langflow-postgres`: This volume is mapped to `/var/lib/postgresql/data` in the container.
+
+## Switching to a Specific LangFlow Version
+
+If you want to use a specific version of LangFlow, you can modify the `image` field under the `langflow` service in the Docker Compose file. For example, to use version 1.0-alpha, change `logspace/langflow:latest` to `logspace/langflow:1.0-alpha`.