From 6ddf69c07b6c492ff2e8b900dff67f8ee2925ae3 Mon Sep 17 00:00:00 2001
From: maebahesioru <pikomaeba@gmail.com>
Date: Wed, 15 Apr 2026 12:34:04 +0900
Subject: [PATCH 1/2] feat: add Nitter service template

---
 svgs/nitter.svg               |  1 +
 templates/compose/nitter.yaml | 88 +++++++++++++++++++++++++++++++++++
 2 files changed, 89 insertions(+)
 create mode 100644 svgs/nitter.svg
 create mode 100644 templates/compose/nitter.yaml

diff --git a/svgs/nitter.svg b/svgs/nitter.svg
new file mode 100644
index 0000000000..2fdb49d90b
--- /dev/null
+++ b/svgs/nitter.svg
@@ -0,0 +1 @@
+<svg version="1" xmlns="http://www.w3.org/2000/svg" width="666.667" height="666.667" viewBox="0 0 500.000000 500.000000"><path d="M73.6 33.6L71 36.3v427.4l2.6 2.7 2.7 2.6h87.4l2.7-2.6 2.6-2.7V339.9c0-102.6.2-123.9 1.3-123.9.8 0 41.1 56.1 89.7 124.7 48.5 68.7 89.2 125.6 90.4 126.5 1.9 1.6 5.5 1.8 37.7 1.8h35.6l2.7-2.6 2.6-2.7V36.3l-2.6-2.7-2.7-2.6h-87.4l-2.7 2.6-2.6 2.7v123.8c0 102.6-.2 123.9-1.3 123.9-.8 0-41.1-56.1-89.7-124.8-48.5-68.6-89.2-125.5-90.4-126.4-1.9-1.6-5.5-1.8-37.7-1.8H76.3l-2.7 2.6zm158.9 147.1c51.2 72.3 94.4 133.1 96.1 134.9 2.9 3.1 3.6 3.4 9.1 3.4 5.2 0 6.4-.4 8.7-2.6l2.6-2.7V49h62v402l-25.2-.1h-25.3l-93-131.6c-51.1-72.3-94.4-133.1-96.1-134.9-2.9-3.1-3.6-3.4-9.1-3.4-5.2 0-6.4.4-8.7 2.6l-2.6 2.7V451H89V49l25.3.1h25.2l93 131.6z"/></svg>
\ No newline at end of file
diff --git a/templates/compose/nitter.yaml b/templates/compose/nitter.yaml
new file mode 100644
index 0000000000..5a2ebacf03
--- /dev/null
+++ b/templates/compose/nitter.yaml
@@ -0,0 +1,88 @@
+# documentation: https://github.com/zedeus/nitter
+# slogan: Alternative Twitter/X front-end focused on privacy.
+# category: social
+# tags: twitter,x,privacy,frontend,proxy
+# logo: svgs/nitter.svg
+# port: 8080
+
+# IMPORTANT: You must provide sessions.jsonl with valid Twitter/X session tokens.
+# Generate it using: https://github.com/zedeus/nitter/tree/master/tools
+
+services:
+  nitter:
+    image: zedeus/nitter:latest
+    environment:
+      - SERVICE_URL_NITTER_8080
+    volumes:
+      - type: bind
+        source: ./nitter.conf
+        target: /src/nitter.conf
+        read_only: true
+        content: |
+          [Server]
+          hostname = "localhost"
+          title = "Nitter"
+          address = "0.0.0.0"
+          port = 8080
+          https = false
+          httpMaxConnections = 100
+          staticDir = "./public"
+
+          [Cache]
+          listMinutes = 240
+          rssMinutes = 10
+          redisHost = "nitter-redis"
+          redisPort = 6379
+          redisPassword = ""
+          redisConnections = 20
+          redisMaxConnections = 30
+
+          [Config]
+          hmacKey = "changeme-random-secret"
+          base64Media = false
+          enableRSS = true
+          maxConcurrentReqs = 2
+          maxRetries = 1
+          retryDelayMs = 150
+
+          [Preferences]
+          theme = "Nitter"
+          proxyVideos = true
+      - type: bind
+        source: ./sessions.jsonl
+        target: /src/sessions.jsonl
+        read_only: true
+        content: ""
+    depends_on:
+      nitter-redis:
+        condition: service_healthy
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD-SHELL", "wget -nv --tries=1 --spider http://127.0.0.1:8080/x/status/20 || exit 1"]
+      interval: 30s
+      timeout: 5s
+      retries: 2
+    user: "998:998"
+    read_only: true
+    security_opt:
+      - no-new-privileges:true
+    cap_drop:
+      - ALL
+
+  nitter-redis:
+    image: redis:6-alpine
+    command: redis-server --save 60 1 --loglevel warning
+    volumes:
+      - nitter-redis:/data
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "redis-cli", "ping"]
+      interval: 30s
+      timeout: 5s
+      retries: 2
+    user: "999:1000"
+    read_only: true
+    security_opt:
+      - no-new-privileges:true
+    cap_drop:
+      - ALL

From f8062d3d5ba96a31cddfccc23584c331dead4f83 Mon Sep 17 00:00:00 2001
From: maebahesioru <pikomaeba@gmail.com>
Date: Wed, 15 Apr 2026 12:37:58 +0900
Subject: [PATCH 2/2] fix: restore correct healthcheck endpoint, add hostname
 comment

---
 templates/compose/nitter.yaml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/templates/compose/nitter.yaml b/templates/compose/nitter.yaml
index 5a2ebacf03..9c2818d9a2 100644
--- a/templates/compose/nitter.yaml
+++ b/templates/compose/nitter.yaml
@@ -20,7 +20,7 @@ services:
         read_only: true
         content: |
           [Server]
-          hostname = "localhost"
+          hostname = "localhost"      # CHANGE THIS to your domain (e.g. nitter.example.com)
           title = "Nitter"
           address = "0.0.0.0"
           port = 8080
@@ -58,7 +58,7 @@ services:
         condition: service_healthy
     restart: unless-stopped
     healthcheck:
-      test: ["CMD-SHELL", "wget -nv --tries=1 --spider http://127.0.0.1:8080/x/status/20 || exit 1"]
+      test: ["CMD-SHELL", "wget -nv --tries=1 --spider http://127.0.0.1:8080/Jack/status/20 || exit 1"]
       interval: 30s
       timeout: 5s
       retries: 2