Skip to content

Installation & Setup

SecureBitChat edited this page Aug 18, 2025 · 1 revision

Installation and Setup Guide

🌐 Online Usage (Recommended)

  1. Visit https://securebitchat.github.io/securebit-chat/
  2. No installation required
  3. Works in any modern browser

🏠 Self-Hosting

Requirements

  • Web server with HTTPS support
  • Modern browser with WebRTC
  • Lightning wallet with WebLN (for payments)

Hosting Options

1. GitHub Pages

git clone https://github.com/SecureBitChat/securebit-chat.git
cd securebit-chat
# Upload files to GitHub Pages repository

2. Netlify/Vercel

git clone https://github.com/SecureBitChat/securebit-chat.git
# Upload folder to Netlify or Vercel

3. Local Server

git clone https://github.com/SecureBitChat/securebit-chat.git
cd securebit-chat

# Python
python -m http.server 8000

# Node.js
npx serve .

# PHP
php -S localhost:8000

HTTPS Configuration

WebRTC requires HTTPS:

  • Use Let's Encrypt for free certificates
  • Configure automatic certificate renewal
  • Ensure proper CORS configuration

Configuration

Environment Variables

# Optional: Custom Lightning node
LIGHTNING_NODE_URL=your_node_url
LIGHTNING_NODE_TOKEN=your_token

# Optional: Custom STUN/TURN servers
STUN_SERVERS=stun:stun.l.google.com:19302
TURN_SERVERS=turn:your_turn_server

Browser Requirements

  • Chrome 60+ / Firefox 60+ / Safari 12+
  • HTTPS connection (required for WebRTC)
  • JavaScript enabled
  • WebRTC support
Clone this wiki locally