⬡ HAVEN — Private Chat That Lives On Your Machine

Your server. Your rules. No cloud. No accounts with Big Tech. No one reading your messages.

---

What Is This?

Haven is a private chat server you run on your own computer. Think Discord, but:

• You own everything — messages, data, the server itself
• Nothing leaves your machine — no cloud, no telemetry, no analytics
• No account with anyone — no email, no phone number, no verification
• Free forever — no subscriptions, no Nitro, no ads

You launch it, your friends connect to your IP address, and you have a private group chat with voice, images, themes, and games. That's it.

---

Features

Category	What You Get
Chat	Real-time messaging, image uploads (paste/drag/drop), typing indicators, message editing, replies, emoji reactions, @mentions with autocomplete
Voice	Peer-to-peer audio chat, per-user volume sliders, mute/deafen
Formatting	Bold, italic, strikethrough, code, ||spoilers||, auto-linked URLs
Slash Commands	/shrug, /tableflip, /roll 2d20, /flip, /me, /spoiler, /tts, and more — type / to see them all
Search	Search messages in any channel with Ctrl+F
Themes	12 built-in themes: Haven, Discord, Matrix, Tron, HALO, LoTR, Cyberpunk, Nord, Dracula, Bloodborne, Ice, Abyss
Multi-Server	Add friends' Haven servers to your sidebar with live online/offline status
Notifications	5 notification sounds, per-channel volume controls
Moderation	Admin: kick, mute (timed), ban, delete users, delete channels, auto-cleanup
Security	Bcrypt passwords, JWT auth, HTTPS/SSL, rate limiting, CSP headers, input validation
Game	Built-in Shippy Container mini-game with server-wide leaderboard

---

Quick Start (Windows)

1. Install Node.js

Download and install from nodejs.org (LTS version). Restart your PC after installing.

2. Download Haven

Download this repository and unzip it anywhere. Desktop is fine.

3. Launch

Double-click Start Haven.bat

A terminal window opens. When you see HAVEN is running, it's ready.

4. Open the App

Your browser should open automatically. If not, go to:

https://localhost:3000

You'll see a certificate warning — that's normal. Click Advanced → Proceed. Haven uses a self-signed certificate for encryption.

5. Create Your Admin Account

1. Click Register
2. Use the username admin (or whatever you set in .env)
3. Pick a password
4. You're now the admin — you can create channels

6. Create a Channel & Invite Friends

1. Type a channel name in the sidebar and click Create
2. A channel code appears (8 characters like a3f8b2c1)
3. Send this code + your IP address to your friends
4. They go to https://YOUR_IP:3000, register, and enter the code

---

Quick Start (Linux / macOS)

chmod +x start.sh
./start.sh

The script handles everything: checks Node.js, installs dependencies, generates SSL certs, and launches.

Or manually:

npm install
node server.js

---

Letting Friends Connect Over the Internet

If your friends aren't on your WiFi, you need to open a port on your router.

Step 1 — Find Your Public IP

Go to whatismyip.com. That's the address your friends will use.

Step 2 — Port Forward

1. Log into your router (usually http://192.168.1.1 or http://10.0.0.1)
2. Find Port Forwarding (sometimes called NAT or Virtual Servers)
3. Forward port 3000 (TCP) to your PC's local IP
4. Save

Find your local IP: Open Command Prompt → type ipconfig → look for IPv4 Address (e.g. 192.168.1.50)

Step 3 — Windows Firewall

Open PowerShell as Administrator and run:

New-NetFirewallRule -DisplayName "Haven Chat" -Direction Inbound -LocalPort 3000 -Protocol TCP -Action Allow

Step 4 — Share With Friends

Send them:

https://YOUR_PUBLIC_IP:3000

Tell them to click Advanced → Proceed on the certificate warning. It's normal.

---

Configuration

Settings are in the .env file (created automatically on first launch):

Setting	Default	What It Does
PORT	3000	Server port
SERVER_NAME	Haven	Your server's display name
ADMIN_USERNAME	admin	Register with this name to get admin powers
JWT_SECRET	(auto-generated)	Security key — don't share or edit this
SSL_CERT_PATH	./certs/cert.pem	Path to SSL certificate
SSL_KEY_PATH	./certs/key.pem	Path to SSL private key

After editing .env, restart the server.

---

Slash Commands

Type / in the message box to see the full list. Here are some highlights:

Command	What It Does
/shrug	¯\(ツ)/¯
/tableflip	(╯°□°)╯︵ ┻━┻
/unflip	┬─┬ ノ( ゜-゜ノ)
/roll 2d20	Roll dice (any NdN format)
/flip	Flip a coin
/me does something	Italic action text
/spoiler secret text	Hidden spoiler text
/tts hello	Text-to-speech
/nick NewName	Change your username
/clear	Clear your chat view
/bbs	"Will be back soon"
/afk	"Away from keyboard"

---

Themes

12 themes, switchable from the sidebar:

Haven · Discord · Matrix · Tron · HALO · Lord of the Rings · Cyberpunk · Nord · Dracula · Bloodborne · Ice · Abyss

Your theme choice persists across sessions.

---

Voice Chat

1. Join a text channel
2. Click 🎤 Join Voice
3. Allow microphone access
4. Adjust anyone's volume with their slider
5. Click 📞 Leave when done

Voice is peer-to-peer — audio goes directly between users, not through the server. Requires HTTPS.

---

Admin Guide

If you registered with the admin username, you can:

• Create / delete channels
• Kick users — disconnects them (they can rejoin)
• Mute users — timed mute (can't send messages)
• Ban users — permanent ban (can't connect)
• Delete users — remove banned accounts (frees up their username)
• Auto-cleanup — configure automatic deletion of old messages (Settings → Admin)
• Server settings — EULA, max message age, DB size limits

Access admin controls in the Settings panel (⚙️ gear icon in the sidebar).

---

Troubleshooting

Problem	Fix
"Node.js is not installed"	Install from nodejs.org. Restart PC.
Browser shows blank page	Clear cache or try incognito/private window
Friends can't connect	Check port forwarding + firewall. Make sure server is running.
"Error: EADDRINUSE"	Another app is using port 3000. Change PORT in .env.
Voice chat echoes	Use headphones
Voice doesn't work remotely	Must use https://, not http://
Certificate error in browser	Normal — click Advanced → Proceed

---

Keyboard Shortcuts

Key	Action
Enter	Send message
Shift+Enter	New line
Ctrl+F	Search messages
Escape	Close search / modals
@	@mention autocomplete
/	Slash command autocomplete
↑ ↓	Navigate autocomplete
Tab	Select autocomplete suggestion

---

Backing Up Your Data

Everything lives in one file: haven.db in the Haven folder. Copy it somewhere safe to back up all your messages, users, and channels.

---

License

MIT — free to use, modify, and share.

---

⬡ Haven — Because your conversations are yours.