Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Self-host MiroTalk P2P
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
A self-hosted WebRTC meeting server in Node.js where audio, video and screen sharing travel directly between the participants' browsers and the server only handles signalling. Rooms need no accounts; it adds chat with Markdown, a whiteboard, file sharing, polls, recording and a REST API, with optional room passwords, a lobby, host protection and OIDC sign-in. AGPL-3.0, with paid one-time licences for closed-source or rebranded use. Because every participant sends to every other, it suits small meetings, and browsers only grant camera access over HTTPS or on localhost.
Pick MiroTalk P2P when you want browser video meetings with no accounts and no media server to run: it is a WebRTC app where audio, video and screen sharing travel directly between participants and the server only handles signalling. You open a room by its URL; it adds chat with Markdown, a whiteboard, file sharing, polls, recording and a REST API, with optional room passwords, a lobby, host protection and OIDC sign-in. It is AGPL-3.0 Node.js, and the README sells separate one-time licences for closed-source or rebranded use. Our snippet is the project's `docker-compose.template.yml` with a minimal `.env` (random JWT key and API secret, a public STUN server, no TURN, the project's stats beacon switched off). Docker Hub publishes only a `latest` tag for `mirotalk/p2p`, so we pin the image digest built on 2026-11-06, which reports app version 2.2.71. We did not find an upstream RAM minimum, so our 512 MB floor is an estimate. The catalog's Jitsi Meet runs a separate Videobridge that relays media for larger meetings and asks for a 2048 MB floor; MiroTalk P2P is a single container that suits small groups.
What you need
Any VPS with at least 512 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# MiroTalk P2P — peer-to-peer video meetings — based on the project's docker-compose.template.yml, pinned to the mirotalk/p2p image built 2026-11-06 (app 2.2.71; Docker Hub publishes only a latest tag)echo "JWT_KEY=$(openssl rand -hex 32)" > .envecho "API_KEY_SECRET=$(openssl rand -hex 24)" >> .envcat >> .env <<'EOF'NODE_ENV=productionPORT=3000TRUST_PROXY=falseLOGS_DEBUG=falseSTUN_SERVER_ENABLED=trueSTUN_SERVER_URL=stun:stun.l.google.com:19302TURN_SERVER_ENABLED=falseSTATS_ENABLED=falseEOFcat > docker-compose.yml <<'EOF'services: mirotalk: image: mirotalk/p2p:latest@sha256:46ecf76700683f59081b526a24333c098056b68fbf0e33573f3e0b2f3a519f14 container_name: mirotalk hostname: mirotalk user: '1000:1000' restart: unless-stopped init: true stop_grace_period: 15s ports: - '3000:3000' volumes: - ./.env:/src/.env:roEOFdocker compose up -dtimeout 120 bash -c 'until curl -fsS -o /dev/null http://localhost:3000/; do sleep 3; done'# → http://SERVER_IP:3000 (cameras and microphones only work on HTTPS or localhost — put a TLS proxy in front; no TURN server is configured)
MiroTalk P2P's README and documentation flag these before you rely on it:
non-negotiableBrowsers only allow camera and microphone access on HTTPS or on localhost, and the self-hosting guide says encrypted communication is required for WebRTC to work correctly. Our snippet serves plain HTTP on port 3000, so put a TLS reverse proxy such as nginx with Certbot in front before anyone joins from another machine.
non-negotiableThe documentation recommends a TURN server for NAT traversal. Our .env configures only Google's public STUN server and leaves TURN off, so participants behind strict NATs or firewalls may fail to connect. The project's .env.template ships TURN credentials for a third-party relay, which we deliberately did not copy.
non-negotiableThere are no version tags to pin: the Docker Hub tag list contains only latest, and the project's own Compose file uses it. We pin by digest for repeatable installs, which means an update is a deliberate digest change that you check against the GitHub releases and package.json version.
non-negotiableMedia is peer to peer, so each participant uploads to every other one. The self-hosting guide calls it ideal for small teams, embedded apps or private instances; larger rooms are what the same author's separate MiroTalk SFU project is for.
non-negotiableAnyone who can reach the server can create rooms: host protection is off by default (HOST_PROTECTED=false) and CORS allows every origin. Set HOST_PROTECTED=true with your own HOST_USERS, since the server refuses the publicly known default accounts, and restrict CORS_ORIGIN when you embed it.
MiroTalk P2P used 129 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 512 MB.
Is the MiroTalk P2P install snippet verified?
The MiroTalk P2P install snippet is marked verified on Ubuntu 26.04 (Nov 2026).