diff --git a/.gitea/README.template b/.gitea/README.template
new file mode 100644
index 0000000..717a0bb
--- /dev/null
+++ b/.gitea/README.template
@@ -0,0 +1,55 @@
+# __REPO_NAME__
+__DESCRIPTION__
+
+
+
+
+
+
+
+
+This repository is built and pushed automatically.
+
+__DOCKERHUB_LINK__
+
+### 🏗️ Platform Support
+| Architecture | Status | Base Image | Build Date |
+| :--- | :--- | :--- | :--- |
+| x86_64 (amd64) | ✅ Active | __BASE_IMAGE__ | __CURRENT_DATE__ |
+| aarch64 (arm64) | __ARM_STATUS__ | __BASE_IMAGE__ | __CURRENT_DATE__ |
+
+---
+
+## 🐙 Method 1: Docker Compose (Recommended)
+
+### 🚀 1. Create `docker-compose.yml`
+```yaml
+__COMPOSE_BLOCK__
+```
+### 🚀 2. Pull & start the container
+### Pull or update the image
+```bash
+docker compose pull
+```
+### Start container in background
+```bash
+docker compose up -d
+```
+---
+
+## 🐳 Method 2: Standalone Container (Docker Run / CLI)
+### 🚀 1. Pull the image manually
+```bash
+docker pull __FULL_URL__:__BUILD_TAG__
+```
+### 🚀 2. Run the container directly
+```bash
+__DOCKER_RUN__
+```
+
+*Last updated on: __CURRENT_DATE__*
+
+### 📜 Version History
+| Version | Date | Status |
+| :--- | :--- | :--- |
+__HISTORY_CONTENT__
\ No newline at end of file