Configuration Guide

ErikrafT Drop™ provides extensive configuration options for different deployment scenarios, from local development to production environments. This guide covers all available configuration options.

Server Configuration

Environment Variables

Basic Server Settings

# Server port (default: 3000)
PORT=3000

# Server host binding (default: 0.0.0.0)
HOST=0.0.0.0

# Debug mode for development (default: false)
DEBUG_MODE=true

# Production mode
NODE_ENV=production

Network Configuration

# LAN-only mode - restrict to local networks
ALLOW_LOCAL_ONLY=true

# WebSocket fallback for WebRTC failures
WS_FALLBACK=true

# Rate limiting for pairing attempts
RATE_LIMIT=true

# IPv6 localization (number of segments)
IPV6_LOCALIZE=2

Redis Configuration (Optional)

# Redis connection URL
REDIS_URL=redis://localhost:6379

# Redis connection options
REDIS_HOST=localhost
REDIS_PORT=6379
REDIS_PASSWORD=
REDIS_DB=0

RTC Configuration

STUN/TURN Servers

{
  "sdpSemantics": "unified-plan",
  "iceServers": [
    {
      "urls": "stun:stun.l.google.com:19302"
    },
    {
      "urls": "turn:turn.example.com:3478",
      "username": "user",
      "credential": "password"
    }
  ]
}

LAN Mode Configuration

// From server.js lines 8-11
const rtcConfig = {
    sdpSemantics: "unified-plan",
    iceServers: []
};

Server Options

Rate Limiting

// From peer.js lines 34-42
rateLimitReached() {
    if (this.requestRate >= 10) {
        return true;
    }
    this.requestRate += 1;
    setTimeout(() => this.requestRate -= 1, 10000);
    return false;
}

Local IP Detection

// From ws-server.js lines 7-30
function isLocalIp(ip) {
    if (!ip) return false;
    if (ip === '127.0.0.1' || ip === '::1') return true;
    if (!ip.includes(":")) {
        return LOCAL_IPV4_PATTERNS.some(pattern => pattern.test(ip));
    }
    // IPv6 validation logic
}

Client Configuration

Browser Settings

WebRTC Configuration

// From network.js lines 153-155
if (this._lanMode.enabled && msg.wsConfig) {
    msg.wsConfig.rtcConfig = { iceServers: [] };
}

LAN Mode Storage

// From network.js lines 1-4
const LAN_STORAGE_KEYS = {
    enabled: 'lan_mode_enabled',
    server: 'lan_signaling_server'
};

Persistent Storage Configuration

IndexedDB Settings

// From persistent-storage.js
class PersistentStorage {
    constructor() {
        this._db = null;
        this._dbName = 'pairdrop-db';
        this._version = 1;
        this._stores = ['room-secrets', 'settings'];
    }
}

Room Secret Storage

// Room secret structure
{
    id: "room-secret-256-char-string",
    secret: "256-character-encrypted-room-secret",
    displayName: "User-chosen-device-name",
    autoAccept: false,
    timestamp: 1640995200000
}

Deployment Configuration

Docker Configuration

Docker Compose

# docker-compose.yml
version: '3.8'
services:
  erikraftdrop:
    build: .
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - DEBUG_MODE=false
      - RATE_LIMIT=true
      - ALLOW_LOCAL_ONLY=false
    restart: unless-stopped
    volumes:
      - ./logs:/app/logs

Dockerfile

FROM node:20-alpine

WORKDIR /app

COPY package*.json ./
RUN npm ci --only=production

COPY . .

EXPOSE 3000

CMD ["npm", "start"]

Docker Swarm Configuration

# docker-compose-swarm.yml
version: '3.8'
services:
  erikraftdrop:
    image: erikraftdrop:latest
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
    deploy:
      replicas: 3
      update_config:
        parallelism: 1
        delay: 10s
        failure_action: rollback
        monitor: 5s
        max_failure_ratio: 0.3

Reverse Proxy Configuration

Nginx Configuration

server {
    listen 80;
    server_name drop.example.com;

    location / {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }

    location /server {
        proxy_pass http://localhost:3000;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection 'upgrade';
        proxy_set_header Host $host;
    }
}

Apache Configuration

<VirtualHost *:80>
    ServerName drop.example.com
    ProxyPreserveHost On
    ProxyRequests Off
    ProxyPass / ws://localhost:3000/
    ProxyPassReverse / ws://localhost:3000/
    ProxyPassReverse /server ws://localhost:3000/
</VirtualHost>

Security Configuration

SSL/TLS Setup

Let’s Encrypt with Nginx

# Install certbot
sudo apt install certbot python3-certbot-nginx

# Generate certificate
sudo certbot --nginx -d drop.example.com

# Auto-renewal
sudo crontab -e
# Add: 0 12 * * * /usr/bin/certbot renew --quiet

SSL Configuration

server {
    listen 443 ssl http2;
    server_name drop.example.com;

    ssl_certificate /etc/letsencrypt/live/drop.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/drop.example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers ECDHE-RSA-AES256-GCM-SHA512:DHE-RSA-AES256-GCM-SHA512;
    ssl_prefer_server_ciphers off;

    location / {
        proxy_pass http://localhost:3000;
        # ... proxy headers
    }
}

Firewall Configuration

UFW (Ubuntu)

# Allow HTTP/HTTPS
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# Allow WebSocket port
sudo ufw allow 3000/tcp

# Enable firewall
sudo ufw enable

iptables

# Allow HTTP/HTTPS
iptables -A INPUT -p tcp --dport 80 -j ACCEPT
iptables -A INPUT -p tcp --dport 443 -j ACCEPT

# Allow WebSocket port
iptables -A INPUT -p tcp --dport 3000 -j ACCEPT

# Save rules
iptables-save > /etc/iptables/rules.v4

Performance Configuration

Node.js Optimization

Process Management

# Increase file descriptor limit
ulimit -n 65536

# Set Node.js options
export NODE_OPTIONS="--max-old-space-size=4096"

# Production optimizations
export NODE_ENV=production

Clustering

// cluster.js example
const cluster = require('cluster');
const numCPUs = require('os').cpus().length;

if (cluster.isMaster) {
    for (let i = 0; i < numCPUs; i++) {
        cluster.fork();
    }
} else {
    require('./server/index.js');
}

Memory Management

iOS Memory Limits

// From network.js lines 819-822
if (window.iOS && request.totalSize >= 200*1024*1024) {
    this.sendJSON({
        type: 'files-transfer-response',
        accepted: false,
        reason: 'ios-memory-limit'
    });
    return;
}

File Chunking Configuration

// From network.js lines 1671-1672
this._chunkSize = 64000; // 64 KB chunks
this._maxPartitionSize = 1e6; // 1 MB partitions

Monitoring and Logging

Application Logging

Development Logging

// Debug mode logging
if (this._conf.debugMode) {
    console.debug("\n");
    console.debug("----DEBUGGING-PEER-IP-START----");
    console.debug("ErikrafTdrop uses:", this.ip);
    console.debug("----DEBUGGING-PEER-IP-END----");
}

Production Logging

# Log rotation
/var/log/erikraftdrop/
├── access.log
├── error.log
└── debug.log

# Logrotate configuration
/var/log/erikraftdrop/*.log {
    daily
    missingok
    rotate 52
    compress
    delaycompress
    notifempty
    create 644 www-data www-data
}

Health Checks

HTTP Endpoints

// From server.js lines 23-27
if (req.url === "/health") {
    res.writeHead(200, { "Content-Type": "text/plain" });
    res.end("ok");
    return;
}

Configuration Endpoint

// From server.js lines 14-21
if (req.url === "/config") {
    res.writeHead(200, { "Content-Type": "application/json" });
    res.end(JSON.stringify({
        lanOnly: true,
        rtcConfig
    }));
    return;
}

Development Configuration

Local Development

# Clone repository
git clone https://github.com/erikraft/Drop.git
cd Drop

# Install dependencies
npm install

# Start development server
npm run dev

# Enable debug mode
DEBUG_MODE=true npm start

Environment Files

# .env file
NODE_ENV=development
PORT=3000
DEBUG_MODE=true
RATE_LIMIT=false
ALLOW_LOCAL_ONLY=true

# .env.production file
NODE_ENV=production
PORT=3000
DEBUG_MODE=false
RATE_LIMIT=true
ALLOW_LOCAL_ONLY=false

CLI Configuration

Command Line Interface

# Configuration file location
~/.erikraftdrop-cli-config

# Configuration options
domain=https://drop.erikraft.com/
default_browser=chrome
download_folder=~/Downloads

CLI Usage

# Show configuration
erikraftdrop --config

# Set custom domain
erikraftdrop -d "https://custom.example.com/"

# Specify browser
erikraftdrop -b firefox file.txt

This comprehensive configuration guide covers all aspects of deploying and customizing ErikrafT Drop™ for different use cases and environments.

​Configuration Guide

​Server Configuration

​Environment Variables

​Basic Server Settings

​Network Configuration

​Redis Configuration (Optional)

​RTC Configuration

​STUN/TURN Servers

​LAN Mode Configuration

​Server Options

​Rate Limiting

​Local IP Detection

​Client Configuration

​Browser Settings

​WebRTC Configuration

​LAN Mode Storage

​Persistent Storage Configuration

​IndexedDB Settings

​Room Secret Storage

​Deployment Configuration

​Docker Configuration

​Docker Compose

​Dockerfile

​Docker Swarm Configuration

​Reverse Proxy Configuration

​Nginx Configuration

​Apache Configuration

​Security Configuration

​SSL/TLS Setup

​Let’s Encrypt with Nginx

​SSL Configuration

​Firewall Configuration

​UFW (Ubuntu)

​iptables

​Performance Configuration

​Node.js Optimization

​Process Management

​Clustering

​Memory Management

​iOS Memory Limits

​File Chunking Configuration

​Monitoring and Logging

​Application Logging

​Development Logging

​Production Logging

​Health Checks

​HTTP Endpoints

​Configuration Endpoint

​Development Configuration

​Local Development

​Environment Files

​CLI Configuration

​Command Line Interface

​CLI Usage