Payambar — Minimal Telegram-like Messenger

A lean 1-to-1 messenger built in Go with embedded frontend, WebSocket real-time chat, and SQLite storage.

Highlights

• Single self-contained binary (frontend embedded)
• WebSocket messaging
• SQLite DB
• File uploads with configurable limit
• PWA frontend (RTL/Farsi ready)

Architecture (quick view)

• Backend: Go (Gin), WebSocket hub, JWT auth
• DB: SQLite file (default /var/lib/payambar/payambar.db in production)
• Storage: Local uploads (default /var/lib/payambar/uploads)
• Frontend: Vuejs PWA served by the binary

Deployment Options

1) Linux installer (systemd, latest GitHub release)

Requirements: Debian/Ubuntu (systemd), curl, python3, tar, (unzip if the release is a zip), systemd. Supported release targets: linux-amd64, linux-arm64.

curl -fsSL https://raw.githubusercontent.com/4xmen/payambar/main/install.sh | sudo bash -s -- --install

Upgrade to the latest release:

curl -fsSL https://raw.githubusercontent.com/4xmen/payambar/main/install.sh | sudo bash -s -- --update

What it does:

• Fetches the latest release asset from GitHub and installs the payambar binary to /opt/payambar.
• Creates system user payambar, data dir /var/lib/payambar (uploads at /var/lib/payambar/uploads), env file /etc/payambar/payambar.env.
• Seeds an empty SQLite DB file, installs a systemd unit, enables the service, and starts/restarts it.
• Default port: 8080. Change PORT or JWT_SECRET in /etc/payambar/payambar.env then sudo systemctl restart payambar.

Common commands:

sudo systemctl status payambar
sudo journalctl -u payambar -f

2) Docker Compose

mkdir payambar && cd payambar
curl -O https://raw.githubusercontent.com/4xmen/payambar/main/docker-compose.yml
cat > .env <<'EOF'
JWT_SECRET=change-me
# Optional:
# CORS_ORIGINS=https://yourdomain.com
# STUN_SERVERS=stun:stun.l.google.com:19302
EOF
docker-compose up -d

Open http://<server-ip>:8080.

3) Build from source

Prereqs: Go 1.25+, Make, SQLite dev headers.

make build-all          # builds frontend + backend → bin/payambar
PORT=8080 DATABASE_PATH=./data/payambar.db JWT_SECRET=dev-key ./bin/payambar

Configuration

Environment variables (used by the binary and the installer-generated env file):

Variable	Default	Purpose
PORT	8080	HTTP/WebSocket port
ENVIRONMENT	production	production or development
DATABASE_PATH	/var/lib/payambar/payambar.db (installer)	SQLite file path
FILE_STORAGE_PATH	/var/lib/payambar/uploads	Upload directory
JWT_SECRET	(randomly generated by installer)	Sign/verify JWT tokens
CORS_ORIGINS	*	Allowed origins
MAX_UPLOAD_SIZE	10485760	Max upload bytes (10MB)
STUN_SERVERS	stun:stun.l.google.com:19302	WebRTC STUN list
TURN_SERVER, TURN_USERNAME, TURN_PASSWORD	(empty)	Optional TURN (voice) — keep empty to disable
PAYAMBAR_ENV_FILE	(empty)	Optional explicit env-file path for CLI/server startup

For CLI usage, config is resolved in this order:

1. Process environment variables
2. PAYAMBAR_ENV_FILE (if set)
3. /etc/payambar/payambar.env (installer default)
4. .env in current working directory

CLI Commands

The binary supports operational CLI commands in addition to running the server:

payambar                # start HTTP/WebSocket server
payambar status         # print app/database/storage statistics
payambar status --json  # same stats as JSON

Example with local build output:

./bin/payambar status
./bin/payambar status --json

File & Directory Layout

cmd/payambar/         # Main entrypoint (embeds static assets)
frontend/             # PWA source
bin/                  # Built binaries (make build-all)
data/                 # Local dev data (SQLite/uploads)
install.sh            # Linux installer (systemd)
docker-compose.yml    # Container deployment

Service Management (installer)

sudo systemctl status payambar
sudo systemctl restart payambar
sudo journalctl -u payambar -f

Ports & Networking

• App listens on PORT (default 8080). Expose/forward this port.
• If enabling voice/TURN later, also open 3478 TCP/UDP and 49152-49252 UDP.

Development Notes

• make dev builds frontend and runs backend with local SQLite at ./data/payambar.db.
• Tests: make test
• Format: make fmt

Troubleshooting

• Service not up: sudo journalctl -u payambar -n 50
• DB locked: SQLite allows one writer; retry or migrate to Postgres for scale.
• WebSocket blocked: Ensure port 8080 open and CDN/proxy allows WebSockets.

---

MIT License