# Tor Shared Hosting A Tor-based shared hosting platform with PHP, MySQL, SFTP, email, and web-based management. Fork of [DanWin/hosting](https://github.com/DanWin/hosting) with Debian 13 support, PHP 8.4/8.5, security hardening, and automated installation. ## Features - PHP 8.2, 8.3, 8.4, 8.5 (user-selectable from dashboard) - Nginx, MariaDB, Dovecot, Postfix, ClamAV, Rspamd - phpMyAdmin, Adminer, SquirrelMail webmail - SFTP and SSH shell access per user - Web-based file manager - PGP-based two-factor authentication - Per-user .onion domains and optional clearnet domains - Auto-scaling Tor instances (1 per ~250 accounts) - Vanity .onion address generation via mkp224o - Zero JavaScript — all pages work without JS - Security hardened (CSP, CSRF, XSS protection, encrypted keys at rest) ## Requirements - **OS:** Debian 13 (Trixie) or Ubuntu 24.04 LTS - **Production:** 1TB SSD, 32GB RAM, 8 CPU cores - **Testing/Personal:** 20GB disk, 4GB RAM, 1 CPU core ## Quick Install One-liner (downloads and runs the installer): ```bash curl -sSL https://raw.githubusercontent.com/bigbong420/hosting/upgrades/install.sh | bash ``` Non-interactive with random passwords: ```bash curl -sSL https://raw.githubusercontent.com/bigbong420/hosting/upgrades/install.sh | bash -s -- --non-interactive ``` With vanity .onion address: ```bash curl -sSL https://raw.githubusercontent.com/bigbong420/hosting/upgrades/install.sh | bash -s -- --non-interactive --vanity mysite ``` ## Manual Install ```bash git clone -b upgrades https://github.com/bigbong420/hosting.git cd hosting ./install.sh ``` ## Install Options ``` ./install.sh [OPTIONS] --non-interactive Skip all prompts, generate random passwords --skip-binaries Skip compiling PHP/ImageMagick (use if already built) --vanity Generate a vanity .onion address (a-z, 2-7 only) --vanity-threads Threads for vanity generation (default: nproc) --db-pass Set hosting MySQL password --pma-pass Set phpMyAdmin MySQL password --admin-pass Set admin panel password ``` Vanity generation times (approximate): | Prefix length | Time | |---|---| | 3 chars | seconds | | 4 chars | minutes | | 5 chars | 10-30 minutes | | 6 chars | hours | | 7+ chars | days | ## Updating ```bash cd /root/hosting ./update.sh # Update code, preserve config ./update.sh --rebuild # Also rebuild PHP/ImageMagick ./update.sh --code-only # Only update PHP files ``` The update script automatically detects if `install_binaries.sh` changed and warns you to rebuild. ## Auto-Scaling Tor instances scale automatically based on account count (~250 accounts per instance). The `hosting-autoscale.timer` checks hourly and adds instances as needed. Instance IDs go `a` through `z`, then `aa`, `ab`, etc. ## Translation Translations are managed in [Weblate](https://weblate.danwin1210.de/projects/DanWin/hosting). The script `update-translations.sh` updates language templates. New translations go in `var/www/YOUR_LANG_CODE/LC_MESSAGES/hosting.po`. ## Manual Configuration After install, you can customize: - **`/var/www/common.php`** — all settings (DB, passwords, PHP versions, features) - **`/etc/postfix/main.cf`** — mail configuration - **`/etc/nginx/sites-enabled/default`** — web server config (auto-generated by `setup.php`) For clearnet domains, add to `relay_domains` in `/etc/postfix/main.cf` and edit: - `/var/www/common.php` - `/etc/postfix/canonical` - `/etc/postfix-clearnet/canonical` For a second postfix instance (clearnet mail relay): ```bash postmulti -e init postmulti -I postfix-clearnet -e create postmulti -i clearnet -e enable postmulti -i clearnet -p start ``` ## Security - CSRF tokens use `random_bytes(32)` - Admin password stored as bcrypt hash - Session regeneration on login - All output escaped with `htmlspecialchars()` - Nginx rewrite rules validated against injection - Onion private keys encrypted at rest (libsodium) - SFTP passwords encrypted in session with 1hr expiry - Admin login rate-limited (exponential backoff) - Content Security Policy: `script-src 'none'` - No JavaScript anywhere ## Architecture ``` /var/www/common.php — shared config and functions /var/www/html/ — web interface (register, login, dashboard, admin) /var/www/setup.php — database schema + service provisioning /var/www/cron.php — account provisioning (runs every minute) /var/www/autoscale.php — instance scaling (runs hourly) /etc/systemd/system/ — PHP-FPM, Tor, timer service files /etc/nginx/ — web server config /etc/tor/ — Tor config /etc/postfix/ — mail config ``` ## TODO: Multi-Server / Clustering - [ ] **Database replication** — MariaDB primary-replica setup for read scaling and failover - [ ] **Shared storage** — GlusterFS or CephFS for `/home` across nodes so user files are accessible from any server - [ ] **Load balancer** — HAProxy or nginx stream proxy in front of multiple Tor-facing nodes - [ ] **Centralized config** — move `common.php` settings to a shared database or etcd so config changes propagate to all nodes - [ ] **Cross-node instance assignment** — extend `get_new_tor_instance()` to assign accounts to instances across multiple servers based on load - [ ] **Distributed autoscale** — autoscale.php should track per-server capacity and spin up instances on the least-loaded server - [ ] **Session sharing** — Redis-based PHP sessions so users can hit any node - [ ] **Mail routing** — single Postfix relay that routes to the correct node based on account location - [ ] **Health monitoring** — centralized health checks across nodes (service status, disk, Tor circuit health) - [ ] **Rolling updates** — update.sh should support updating one node at a time with traffic draining - [ ] **Onion key migration** — tool to move an account (onion keys, files, databases) between servers - [ ] **Shared ClamAV/Rspamd** — run scanning services on dedicated nodes instead of every hosting node - [ ] **Backup orchestration** — coordinated backups across nodes with point-in-time recovery ## License See [COPYING](COPYING) for license information.