diff --git a/README.md b/README.md
index 595889480..a522a3053 100644
--- a/README.md
+++ b/README.md
@@ -30,6 +30,10 @@ PictoPy is an advanced desktop gallery application that combines the power of Ta
 
 Handles file system operations and provides a secure bridge between the frontend and local system.
 
+## Sync Microservice Setup
+
+See `sync-microservice/README.md` for instructions on setting up and running the synchronization microservice.
+
 ## Features
 
 - Smart tagging of photos based on detected objects, faces, and their recognition
diff --git a/sync-microservice/README.md b/sync-microservice/README.md
index d146157a9..9e3bd0cf6 100644
--- a/sync-microservice/README.md
+++ b/sync-microservice/README.md
@@ -190,3 +190,17 @@ This microservice is designed to work alongside the main PictoPy backend:
 - **Shared Database**: Both services use the same SQLite database
 
 The sync service operates independently but relies on the main backend's database structure.
+
+# Sync Microservice Setup
+
+This service handles synchronization tasks for PictoPy.
+
+## Setup
+
+```bash
+cd sync-microservice
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+python main.py
+