Getting Started

How to get started with Surfsense

1

Use Cloud Option

Access SurfSense Cloud for immediate use without installation.

2

Local Docker Deployment

Run the provided docker-compose command to start frontend (localhost:3000), backend API (localhost:8000), and supporting services.

3

Set Up Prerequisites

Configure Google OAuth for Gmail/Calendar, obtain Unstructured API key for file processing, and set up Firecrawl for web crawling.

4

Install Browser Extension

Build the browser extension via Plasmo and load it in developer mode with your API key.

5

Verify Setup

Sign in (e.g., with Google), create a search space, upload a document, and test chat functionality.