Thunder Server

A companion server which handles Thunder related services

Overview • Features • Quick Setup • Configuration

Overview

Thunder Server is an experimental companion service for Thunder that handles push notifications for both UnifiedPush and Apple Push Notification Service (APNs).

Features

• Push Notifications: Supports both UnifiedPush and Apple Push Notification Service (APNs)
• Multi-Account Support: Polls and delivers notifications for multiple accounts
• Docker-Ready: Pre-configured Docker containers for easy deployment

Quick Setup Guide

A docker compose configuration is provided for quick deployment. For custom deployments, docker images are available via GitHub.

Setup

# Clone the repository
git clone https://github.com/thunder-app/thunder-server.git
cd thunder-server

# Copy and configure environment variables
cp example.env .env

# Start the server and database
docker-compose up -d

The server will be available at http://localhost:2831 by default.

Environment Configuration

Configure your environment by copying example.env to .env and updating the following settings:

Application Settings

APP_PORT=2831

Database Configuration

POSTGRES_USER=postgres
POSTGRES_PASSWORD=password
POSTGRES_HOSTNAME=postgres
POSTGRES_PORT=5432
POSTGRES_DATABASE=thunder_database

Apple Push Notifications (APNs)

APNS_KEY_ID=your_key_id                     # Your Apple Developer Key ID
APNS_TEAM_ID=your_team_id                   # Your Apple Developer Team ID
APNS_APP_BUNDLE_ID=com.example.thunder      # Your app's bundle identifier

Note: For APNs to work, you'll need to configure your Apple Developer account and obtain the necessary certificates.