g@m8sh.su f0465712a3 revert(vless): drop the debugging-era session telemetry
Per-session info logs, uplink failure lines, UDP datagram counters and the malformed-frame hex dump served their diagnostic purpose; TCP is back to its single debug-level completion line and UDP logs nothing, leaving only the pre-existing warnings for dial failures and unknown UUIDs

Assisted-by: Cline:GLM-4.7
2026-11-19 19:22:44 +03:00
2026-10-24 13:48:19 +00:00
2024-07-23 12:07:41 +00:00
upd
2026-11-17 21:08:41 +03:00
2025-06-16 12:03:51 +00:00
upd
2026-11-02 21:38:29 +03:00
2023-01-24 18:52:38 +00:00
2026-08-24 07:28:17 +00:00
2026-06-09 19:17:39 +00:00
2026-11-12 18:16:44 +03:00

M8SH — Email evolved

Work in progress

A heavily extended Gitea fork with federated GPG-based auth, email-with-messenger-upgrade, any media streaming, and later — clients for secure interaction with the network (child control).


M8SH is what email should have evolved into. Now it is.

What email got right was simplicity alongside decentralization: anyone could run a server and communicate freely, without a central controlling institution. What it got catastrophically wrong was everything else — cryptography, security, protocols, user experience.

In M8SH the naming convention stays the same — name@example.com — but it provides a full-fledged modernized API for different forms of interaction between users on the network: sharing music, videos, subscribing to each other, posting articles, sending private messages, all reusing that simple email naming — neo@m8sh.su. Of course, backwards compatible with traditional email, just in case it's required, since it's much easier when there is no need for: 1 - email, 2 - messenger, 3 - audio/video conference.

Roadmap

  1. GPG-based registration, auth and authentication — federated by design
  2. Integrated email messenger with audio and video calls/conferences, cross-domain
  3. Fillable with any media from any source VLC server, compatible with all VLC applications
  4. Federated search — indexed across M8SH nodes, accessible via API
  5. Posts, articles, videos, reels, music, reactions, comments

Quick start

Build the binary (Go 1.26+):

git clone https://m8sh.su/x/m8sh.git && cd m8sh
make generate
TAGS="bindata sqlite sqlite_unlock_notify" make build

Install everything else — system user, binary with low-port capability, config with ACME HTTPS, hardened systemd unit, firewall ports (SSH, mail, HTTP/HTTPS, VPN), verified start — with one line on the server (Linux with systemd, run as admin):

sudo ./gitea --setup example.com

The instance is then live at https://example.com/. Subdomains work the same way (--setup my-site.example.com) — a free subdomain from any DNS service is enough. Re-running the command is safe and idempotent (an existing app.ini is never overwritten). For a private/LAN node without a domain and certificates:

sudo ./gitea m8sh setup --domain localhost --http

Requirements: a domain pointing at the server (A record) and ports 22, 25, 80, 443 reachable — the built-in VPN rides the HTTPS port, nothing else to open — on a home connection forward them from the router and check that your ISP allows port 25.

Email is optional

Nodes talk to each other over plain HTTPS — the messenger, media and federation work without any email setup. Email compatibility is one manual step, done whenever wanted: on first start M8SH generates its DKIM key (persisted in app.ini) and the full DNS record set (MX, SPF, DKIM, DMARC), shown in Admin → Email Settings — paste those values into the domain provider's DNS panel and email flows. The same page runs a live DNS check and has a regenerate button; missing records never break the messenger.

To turn the SMTP listener off entirely: [mail_server] ENABLED = false.

Configuration reference

[mail_server] section

Setting Default Description
ENABLED true Enable the built-in SMTP server (port 25). HTTPS chat works regardless; this controls email delivery only. Set to false to disable.
DKIM_PRIVATE_KEY auto-generated Base64 PEM RSA key for DKIM signing. Remove the value and restart to rotate; the new record appears in Admin → Email Settings.
HEALTHCHECK_INTERVAL 5m Interval for mail server health checks
USER_QUOTA 4294967296 (4 GB) Storage quota per user in bytes. Admins always unlimited. Set to 0 for unlimited.

[vless] section — built-in VLESS VPN

The VPN starts automatically with the instance; every user finds their personal vless:// link and an on-demand QR code under Settings → Profile → Vless VPN.

Setting Default Description
ENABLED true Start the built-in VLESS inbound. Set to false to disable (also closes the port).
PORT 8443 Dedicated TCP port for the VPN (raw TCP and websocket transport) — optional, forward it only if you want the extra port.
WEBSOCKET_PATH /vless Path both the VPN port and the web listener accept websocket upgrades on.
MOUNT_ON_WEB true Also serve the websocket entry on the main web listener, so clients connect through ordinary HTTPS (port 443) — no extra port forwarding needed. Share links point there by default.
CERT_FILE / KEY_FILE (server's pair) Optional own TLS pair for the inbound; when empty the [server] CERT_FILE/KEY_FILE pair is reused.

TLS wraps the inbound whenever a cert pair resolves — the share link then carries security=tls; without certs the inbound is plaintext (security=none). Each user's UUID is their credential and can be reset from the settings page, instantly revoking old links.


Licensing

Project is published under GPLv3 license. If you modify GPLv3 code and distribute the resulting software, your entire application must also be licensed under GPLv3.

S
Description
Gitea fork with modern email messenger and custom web-extensions. (WIP)
Readme GPL-3.0
2.1 GiB
0 Stars 1 Watchers 0 Forks
m8sh-alpha
Latest
2026-11-19 16:27:00 +00:00
Languages
Go 79.7%
TypeScript 7.4%
Handlebars 6%
Vue 3.5%
CSS 1.8%
Other 1.4%