wehub-resource-sync
6ede33ccdb
Build and Push Docker Images / create_manifest (web, surfsense-web, , cpu) (push) Has been cancelled
Build and Push Docker Images / finalize_release (push) Has been cancelled
Obsidian Plugin Lint / lint (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, cpu, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64, , runner, false, cpu) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, cpu, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64, , runner, false, cpu) (push) Has been cancelled
Build and Push Docker Images / compute_version (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, cpu, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64, , production, false, cpu) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, cpu, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64, , production, false, cpu) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, cu126, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64, -cuda126, production, true, cuda126) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, cu126, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64, -cuda126, production, true, cuda126) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, cu128, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64, -cuda, production, true, cuda) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, cu128, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64, -cuda, production, true, cuda) (push) Has been cancelled
Build and Push Docker Images / verify_digests (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend, , cpu) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend, -cuda, cuda) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend, -cuda126, cuda126) (push) Has been cancelled
63 lines
2.3 KiB
Plaintext
63 lines
2.3 KiB
Plaintext
---
|
|
title: Docker Setup
|
|
description: Configure messaging channels for Docker and one-line installs
|
|
---
|
|
|
|
# Docker Setup
|
|
|
|
For Docker and one-line installs, configure messaging channels in the generated
|
|
`docker/.env` file. You do not need to edit `surfsense_backend/.env.example`.
|
|
|
|
The Compose stack passes `docker/.env` into the backend, worker, and beat
|
|
containers. Database, Redis, SearXNG, and internal Docker networking are already
|
|
wired by Compose.
|
|
|
|
## Public URLs
|
|
|
|
For localhost-only testing, the defaults are enough for the SurfSense UI, but
|
|
public webhooks from Telegram, WhatsApp, and Slack require a public HTTPS
|
|
SurfSense URL. Use your deployed domain or a tunnel such as Cloudflare Tunnel
|
|
or ngrok.
|
|
|
|
When using a custom domain or tunnel with the bundled Caddy proxy, set:
|
|
|
|
```bash
|
|
SURFSENSE_PUBLIC_URL=https://surf.example.com
|
|
SURFSENSE_SITE_ADDRESS=surf.example.com
|
|
LISTEN_HTTP_PORT=80
|
|
LISTEN_HTTPS_PORT=443
|
|
CERT_EMAIL=you@example.com
|
|
GATEWAY_BASE_URL=https://surf.example.com
|
|
```
|
|
|
|
## Environment Variables
|
|
|
|
Uncomment only the channel you are enabling in `docker/.env`.
|
|
|
|
| Channel | Main variables |
|
|
| --- | --- |
|
|
| Telegram | `TELEGRAM_SHARED_BOT_TOKEN`, `TELEGRAM_SHARED_BOT_USERNAME`, `TELEGRAM_WEBHOOK_SECRET`, `GATEWAY_BASE_URL`, `GATEWAY_TELEGRAM_INTAKE_MODE` |
|
|
| WhatsApp Cloud API | `GATEWAY_WHATSAPP_INTAKE_MODE`, `WHATSAPP_SHARED_BUSINESS_TOKEN`, `WHATSAPP_SHARED_PHONE_NUMBER_ID`, `WHATSAPP_SHARED_DISPLAY_PHONE_NUMBER`, `WHATSAPP_SHARED_WABA_ID`, `WHATSAPP_WEBHOOK_VERIFY_TOKEN`, `WHATSAPP_WEBHOOK_APP_SECRET` |
|
|
| WhatsApp Baileys | `GATEWAY_WHATSAPP_INTAKE_MODE`, `WHATSAPP_BRIDGE_URL`, `WHATSAPP_MODE` |
|
|
| Slack | `SLACK_CLIENT_ID`, `SLACK_CLIENT_SECRET`, `GATEWAY_SLACK_ENABLED`, `GATEWAY_SLACK_SIGNING_SECRET`, `GATEWAY_SLACK_REDIRECT_URI` |
|
|
| Discord | `DISCORD_CLIENT_ID`, `DISCORD_CLIENT_SECRET`, `DISCORD_BOT_TOKEN`, `GATEWAY_DISCORD_ENABLED`, `GATEWAY_DISCORD_REDIRECT_URI` |
|
|
|
|
After editing `docker/.env`, restart the stack:
|
|
|
|
```bash
|
|
docker compose up -d
|
|
```
|
|
|
|
For WhatsApp Baileys, start the Compose profile:
|
|
|
|
```bash
|
|
docker compose --profile whatsapp up -d
|
|
```
|
|
|
|
Then follow the per-channel setup pages:
|
|
|
|
- [Telegram](/docs/messaging-channels/telegram)
|
|
- [WhatsApp](/docs/messaging-channels/whatsapp)
|
|
- [Slack](/docs/messaging-channels/slack)
|
|
- [Discord](/docs/messaging-channels/discord)
|