diff --git a/compose-configs/Mirage/compose.yml b/compose-configs/Mirage/compose.yml
new file mode 100644
index 0000000..1a94d59
--- /dev/null
+++ b/compose-configs/Mirage/compose.yml
@@ -0,0 +1,18 @@
+# self-coded alternative frontend to miraheze
+services:
+  mirage:
+    image: ghcr.io/gigirassy/mirage:main
+    container_name: mirage
+    env_file: .env
+    ports:
+      - "127.0.0.1:35200:3000" # change first if already taken
+    environment:
+      - PYTHONUNBUFFERED=1
+      - MIRAGE_CACHE_MAX=41943040    # 40 MB
+      - MIRAGE_CACHE_TTL=604800      # 7 days
+      - MIRAGE_CACHE_KEY=${MIRAGE_CACHE_KEY}
+      - USER_AGENT=Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0
+    volumes:
+      - ./cache:/app/cache:rw
+    restart: unless-stopped
+    mem_limit: 50m
\ No newline at end of file