From a9409cb99209a8c171bf8d8767ed21800967260d Mon Sep 17 00:00:00 2001
From: germondai <germondai@gmail.com>
Date: Sun, 31 May 2026 11:45:00 +0200
Subject: [PATCH] chore: add docker config and env template

---
 .dockerignore | 13 +++++++++++++
 .env.example  | 28 ++++++++++++++++++++++++++++
 2 files changed, 41 insertions(+)
 create mode 100644 .dockerignore
 create mode 100644 .env.example

diff --git a/.dockerignore b/.dockerignore
new file mode 100644
index 0000000..12ab69a
--- /dev/null
+++ b/.dockerignore
@@ -0,0 +1,13 @@
+**/node_modules
+**/.nuxt
+**/.output
+**/.vitepress/dist
+**/.vitepress/cache
+**/dist
+**/.env
+**/.env.*
+!**/.env.example
+**/*.md
+!apps/docs/**/*.md
+.github/
+docker-compose*.yml
diff --git a/.env.example b/.env.example
new file mode 100644
index 0000000..78ad16e
--- /dev/null
+++ b/.env.example
@@ -0,0 +1,28 @@
+REDIS_URL=redis://localhost:6379
+BROWSER_POOL_SIZE=5
+SESSION_TTL_SECONDS=3600
+PROXY_URL=
+RESIDENTIAL_PROXY_URL=
+PORT_API=8191
+PORT_WEB=3000
+PORT_DOCS=3001
+
+# --- reCAPTCHA v2 audio solving (optional) ---
+#
+# By default TRAWL uses Google's own free Speech API to transcribe reCAPTCHA
+# audio challenges — no key or signup needed. If you want to use a local
+# Whisper server instead (fully air-gapped), set STT_URL:
+#
+#   whisper.cpp server:         STT_URL=http://localhost:8080/inference
+#   faster-whisper-server:      STT_URL=http://localhost:8000/v1/audio/transcriptions
+STT_URL=
+STT_API_KEY=
+
+# Chrome executable path (overrides default /usr/bin/google-chrome inside Docker)
+CHROME_EXECUTABLE=
+
+# Optional: full path to the ffmpeg binary for reCAPTCHA audio transcoding.
+# Docker installs ffmpeg via apt so this isn't needed in production.
+# On macOS with Playwright's bundled binary (ffmpeg-mac), either set this or create a symlink:
+#   ln -sf ~/.cache/ms-playwright/ffmpeg-*/ffmpeg-mac ~/.local/bin/ffmpeg
+FFMPEG_PATH=