Build & Deploy Sub Search

1. 1. Install Python 3.11+ and git
2. 2.
   Clone and set up virtual environment:

   git clone https://github.com/ericrosenberg1/reddit-sub-analyzer.git
   cd reddit-sub-analyzer
   python3 -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

3. 3.
   Set up PostgreSQL and Redis:

   # PostgreSQL
   createdb subsearch
   
   # Redis (via Docker)
   docker run -d --name redis -p 6379:6379 redis:alpine

4. 4.
   Run migrations and start the server:

   python manage.py migrate
   python manage.py runserver  # http://localhost:8000

5. 5.
   Start Celery workers (separate terminal):

   celery -A reddit_analyzer worker --loglevel=info

Copy .env.example to .env and fill in these values:

For production, use Gunicorn with your preferred process manager:

pip install gunicorn
gunicorn reddit_analyzer.wsgi:application --bind 0.0.0.0:8000 --workers 4

Use systemd, supervisor, or Docker to manage the Django app and Celery workers.

Sub Search uses a priority-based task queue. Start both worker and beat scheduler:

# Worker (handles task execution)
celery -A reddit_analyzer worker --loglevel=info

# Beat (schedules periodic tasks)
celery -A reddit_analyzer beat --loglevel=info

1. 1. Set PHONE_HOME=true in your .env
2. 2. Point PHONE_HOME_ENDPOINT at the main collector
3. 3. Add PHONE_HOME_TOKEN if you have one (Bearer auth)
4. 4. Set PHONE_HOME_SOURCE to label your node
5. 5. Run Sub Search as usual - data syncs automatically!

Nodes add extra throughput by lending your computer + Reddit account:

• • Open the Nodes page and submit the "Add a node" form
• • Use the private link emailed to you to update availability or pause the node
• • Mark a node as "broken" if it goes offline - automatic cleanup after 7 days