Repository navigation
wamux-http 0.1.0
Added
- WAHA-compatible HTTP server on top of the wamux core (contract pinned to
wamux v0.2.1 and WAHA 2026.8.2). - Sessions: create, list, get, update, delete, start, stop, restart, logout,
me, and the deprecated body-named forms. A session is a wamux account;
its desired state survives restarts and it reconnects after a drop, except
after a logout or a ban. - Pairing by QR (PNG, base64 JSON or raw value) and by phone code.
- API keys in the WAHA Plus model: the admin key from
WAHA_API_KEY
(plain orsha512:), and session keys withactions. Keys are stored as
hashes, so listings show them masked. - A session key can cover several sessions:
/api/keystakes and returns
sessionsnext to WAHA'ssession. - Container images on GHCR, both
FROM scratchwith one static binary and
run as uid 10001:ghcr.io/llawli/wamux-http:vX.Y.Z(35 MB) and
vX.Y.Z-ffmpeg(430 MB, with ffmpeg and ffprobe for voice and video
conversion). A static Linux x86_64 tarball with every release; the tarball
and both images carry the same binary, with provenance attestations. - Reference
compose.yamlrunning the core and this edge from GHCR (it
replacesdeploy/docker-compose.yml). wamux-http --version.- CA roots compiled in, used when the host has none (a scratch container):
https webhooks and media fetches verify there too. - WebP images get thumbnails without ffmpeg.
- Web panel at
/dashboard, unlocked with the admin key: pair sessions by QR
or phone code with live status, start, stop, restart, log out and delete
them, edit their webhooks and metadata and the account's name, about and
picture, and create, deactivate and revoke API keys.
WAHA_DASHBOARD_ENABLED=falseturns it off. - Webhooks with WAHA's envelope, headers, HMAC-SHA512 signature and retry
policies, delivered from a durable outbox. - Every WAHA operation not implemented yet answers WAHA's 501;
docs/coverage.mdlists them. - Built to run several instances on one store: sessions are owned by lease.
/ws: every event, in the webhook envelope, filtered by session and event.- Incoming messages, acks, reactions, edits, revokes, poll votes, presence,
group, call, label and archive events as WAHA webhooks, honoring
config.ignore; history sync fills chats, messages and contacts without
webhooks. - Chats (list, overview, messages, picture, read, archive, unread, delete,
edit), label reads, presence, and the deprecatedGET /api/messages. - Sends: text with link previews, image, file, voice, video, sticker,
contact, poll and poll vote, buttons reply, reactions, stars, read
receipts and typing. Sends answer a WAMessage carrying_data. - Text, image and video statuses, and status delete.
- Voice and video conversion with ffmpeg, and
/api/filesserving received
media, downloaded from the core on first request. - Client URLs are fetched behind an SSRF guard
(WAMUX_HTTP_MEDIA_ALLOW_PRIVATE,WAMUX_HTTP_MEDIA_MAX_BYTES,
WAMUX_HTTP_MEDIA_FETCH_TIMEOUT). - Contacts and LIDs, block and unblock, groups (create, list, participants,
admins, invites, join requests, security settings, picture), profile
(name, about, picture), channels (list, info, message preview, create,
follow, unfollow, mute, unmute) and call rejection. Block, about, the group
approval and add modes, the channel writes and call rejection need wamux
v0.2.1; on v0.2.0 they answer 501.
Run
Both images run the binary in the tarball below, as uid 10001, from scratch:
ghcr.io/llawli/wamux-http:v0.1.0: the binary aloneghcr.io/llawli/wamux-http:v0.1.0-ffmpeg: plus ffmpeg and ffprobe, for voice and video conversion, waveforms and durations
Next to the core: the reference compose.yaml.
Verify
The tarball and both images carry a build provenance attestation; the images are published by a job that starts after this release, so they can appear a few minutes later.
gh attestation verify wamux-http-0.1.0-linux-amd64.tar.gz -R LLawli/wamux-http
gh attestation verify oci://ghcr.io/llawli/wamux-http:v0.1.0 -R LLawli/wamux-http
Licenses (added after release)
This release's images shipped without the license notices that v0.1.1 adds; use v0.1.1. The ffmpeg and ffprobe in ghcr.io/llawli/wamux-http:v0.1.0-ffmpeg are the same binaries as in v0.1.1 (mwader/static-ffmpeg:9.0.2), GPL-3.0-or-later. Their complete corresponding source is the static-ffmpeg-9.0.2-source release, and the GPL text and every component's license are in /usr/local/share/doc/ffmpeg of the v0.1.1-ffmpeg image and in packaging/ffmpeg/doc. The notices of what the wamux-http binary links are in THIRD-PARTY-LICENSES.md.