From fcaaa1d03cc306250c10cfc3f1a50895c65d16e6 Mon Sep 17 00:00:00 2001
From: ramvignesh-b <ramvignesh-b@github.com>
Date: Thu, 21 May 2026 14:07:49 +0530
Subject: [PATCH] docs: add container registry instructions to README

---
 README.md | 33 +++++++++++++++++++++++++++------
 1 file changed, 27 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 725fcbb..0834c01 100644
--- a/README.md
+++ b/README.md
@@ -59,12 +59,33 @@ Open `.env`, define your own strong `API_KEY`, and map the ports (optional)
 #### Option A: Docker Compose (Recommended)
 The easiest way to get up and running. This spins up both toknd and a dedicated Redis instance.
 
-- **Production**:
-  ```bash
-  docker compose up -d --build
-  (or)
-  podman compose up -d --build
-  ```
+You can run toknd by building the container locally or by pulling the pre-built image from the **GitHub Container Registry (GHCR)**.
+
+##### Using Pre-built Image (GHCR)
+Instead of building locally, you can pull the pre-built image. Update the `app` service in `docker-compose.yml` to pull the image:
+
+```yaml
+services:
+  app:
+    image: ghcr.io/ramvignesh-b/toknd:latest
+    # build: .  # Comment or remove this line
+```
+
+Then start the services:
+```bash
+docker compose up -d
+(or)
+podman compose up -d
+```
+
+##### Building from Source
+If you prefer to build the image locally:
+```bash
+docker compose up -d --build
+(or)
+podman compose up -d --build
+```
+
 
 
 #### Option B: Bare Metal