Discord OAuth Integration Setup Guide

This guide walks you through setting up a Discord OAuth integration for SurfSense.

Step 1: Create a New Discord Application

1. Navigate to discord.com/developers/applications
2. Click "New Application"
3. Enter the application name: SurfSense
4. Click "Create"

Step 2: Configure General Information

On the General Information page, fill in the details:

You'll also see your Application ID and Public Key on this page.

Step 3: Configure OAuth2 Settings

1. In the left sidebar, click "OAuth2"
2. Copy your Client ID and Client Secret (click to reveal)
3. Under Redirects, click "Add Another" and enter:

   http://localhost:8000/api/v1/auth/discord/connector/callback

⚠️ Keep Public Client disabled (off) since SurfSense uses a server to make requests.

Step 4: Configure Bot Settings

1. In the left sidebar, click "Bot"

2. Configure the Authorization Flow:

   • ✅ Public Bot - Enable to allow anyone to add the bot to servers

3. Enable Privileged Gateway Intents:

   • ✅ Server Members Intent - Required to receive GUILD_MEMBERS events
   • ✅ Message Content Intent - Required to receive message content

⚠️ Once your bot reaches 100+ servers, these intents will require verification and approval.

Running SurfSense with Discord Connector

Add the Discord environment variables to your Docker run command:

docker run -d -p 3000:3000 -p 8000:8000 \
  -v surfsense-data:/data \
  # Discord Connector
  -e DISCORD_CLIENT_ID=your_discord_client_id \
  -e DISCORD_CLIENT_SECRET=your_discord_client_secret \
  -e DISCORD_REDIRECT_URI=http://localhost:8000/api/v1/auth/discord/connector/callback \
  -e DISCORD_BOT_TOKEN=http://localhost:8000/api/v1/auth/discord/connector/callback \
  --name surfsense \
  --restart unless-stopped \
  ghcr.io/modsetter/surfsense:latest