Categorii

MiroTalk C2C

MiroTalk C2C Self-Hosting Guide

mirotalk-c2c

Description

MiroTalk C2C is a Direct client-to-client messaging and media exchange for low-latency real-time communication. Suited for private chats, small apps, or embedded solutions.

Live demo: https://c2c.zalimag.com

Requirements

Server Selection:
- Hetzner - Use this link to receive €⁠20 in cloud credits
- Netcup
- Hostinger
- Contabo
OS: Ubuntu 22.04 LTS.
Node.js (LTS) and npm
Domain or Subdomain Name (e.g., YOUR.DOMAIN.NAME) with a DNS A record pointing to your server's IPv4 address.
Recommend utilizing a Turn Server the installation documentation accessible here.

Installation

nodejs

Install NodeJS and npm using Node Version Manager

Quick start

Bash

# Clone the project repo
$ git clone https://github.com/miroslavpejic85/mirotalkc2c.git

# Go to project dir
$ cd mirotalkc2c

# Copy .env.template in .env and customize it according to your needs if needed
$ cp .env.template .env

# Install dependencies
$ npm ci

# Start the server
$ npm start

Check if is correctly installed: http://YOUR.DOMAIN.NAME:8080

Using PM2 (Process Manager)

pm2

Bash

# Install pm2
$ npm install -g pm2

# Start the server
$ pm2 start backend/server.js --name mirotalkc2c

# Takes a snapshot
$ pm2 save

# Add it on startup
$ pm2 startup

Using Docker

docker

Bash

# Install docker
$ sudo apt install -y docker.io

# Instal docker-compose
$ sudo apt install -y docker-compose

# Clone the project repo
$ git clone https://github.com/miroslavpejic85/mirotalkc2c.git

# Go to project dir
$ cd mirotalkc2c

# Copy .env.template in .env and customize it according to your needs if needed
$ cp .env.template .env

# Copy docker-compose.template.yml in docker-compose.yml and customize it according to your needs if needed
$ cp docker-compose.template.yml docker-compose.yml

Example of docker-compose.yml:

YAML

services:
    mirotalkc2c:
        image: mirotalk/c2c:latest
        container_name: mirotalkc2c
        hostname: mirotalkc2c
        restart: unless-stopped
        ports:
            - '${PORT}:${PORT}'
        volumes:
            - .env:/src/.env:ro
            - ./frontend/:/src/frontend/:ro
            - ./backend/:/src/backend/:ro

Bash

# Pull the official Docker image
$ docker-compose pull

# Create and start containers (-d as daemon)
$ docker-compose up

Check if is correctly installed: http://YOUR.DOMAIN.NAME:8080

Configuring Nginx & Certbot

nginx

In order to use it without the port number and to have encrypted communications (mandatory to make it work correctly), we going to install nginx and certbot

Bash

# Install Nginx
$ sudo apt-get install -y nginx

# Install Certbot (SSL certificates)
$ sudo apt install -y snapd
$ sudo snap install core; sudo snap refresh core
$ sudo snap install --classic certbot
$ sudo ln -s /snap/bin/certbot /usr/bin/certbot

# Configure Nginx
$ sudo vim /etc/nginx/sites-enabled/default

Add the following:

Bash

# HTTP — redirect all traffic to HTTPS
server {
    listen 80;
    listen [::]:80;
    server_name YOUR.DOMAIN.NAME;

    return 301 https://$host$request_uri;
}

Bash

# Test Nginx configuration
$ sudo nginx -t

# Enable HTTPS with Certbot (follow the instruction)
$ sudo certbot certonly --nginx

# Add Let's Encrypt configuration to Nginx
$ sudo vim /etc/nginx/sites-enabled/default

Add the following:

Bash

# MiroTalk C2C - HTTPS — proxy all requests to the Node app
server {
    # Enable HTTP/2
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name YOUR.DOMAIN.NAME;

    # Use the Let’s Encrypt certificates
    ssl_certificate /etc/letsencrypt/live/YOUR.DOMAIN.NAME/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/YOUR.DOMAIN.NAME/privkey.pem;

    location / {
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;
        proxy_pass http://localhost:8080/;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

Bash

# Test Nginx configuration again
$ sudo nginx -t

# Restart nginx
$ service nginx restart
$ service nginx status

# Set up auto-renewal for SSL certificates
$ sudo certbot renew --dry-run --cert-name YOUR.DOMAIN.NAME

# Show certificates
$ sudo certbot certificates

Check Your MiroTalk C2C instance: https://YOUR.DOMAIN.NAME

Apache Virtual Host (Alternative to Nginx)

apache

If you prefer Apache, configure it with the equivalent settings provided in this guide.

Bash

# Install apache with certbot
$ apt install python3-certbot-apache -y

# Setting up ssl
$ certbot --apache --non-interactive --agree-tos -d YOUR.DOMAIN.NAME -m your.email.address

# Edit the apache sites
$ sudo vim /etc/apache2/sites-enabled/YOUR.DOMAIN.NAME.conf

Add the following:

Bash

# HTTP — redirect all traffic to HTTPS
<VirtualHost *:80>
    ServerName YOUR.DOMAIN.NAME
    Redirect permanent / https://YOUR.DOMAIN.NAME
</VirtualHost>

# MiroTalk C2C - HTTPS — proxy all requests to the Node app
<VirtualHost *:443>
    ServerName YOUR.DOMAIN.NAME

    # SSL Configuration
    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/YOUR.DOMAIN.NAME/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/YOUR.DOMAIN.NAME/privkey.pem
    Include /etc/letsencrypt/options-ssl-apache.conf

    # Enable HTTP/2 support
    Protocols h2 http/1.1

    <Location />
        # Proxy Configuration for Node.js App
        ProxyPass http://localhost:8080/
        ProxyPassReverse http://localhost:8080/

        ProxyPreserveHost On

        RequestHeader set X-Forwarded-For "%{REMOTE_ADDR}s"
        RequestHeader set X-Forwarded-Proto "https"
        RequestHeader set Host "%{HTTP_HOST}s"

        # Enable WebSocket proxy support for Socket.IO
        RewriteEngine On
        RewriteCond %{HTTP:Upgrade} =websocket [NC]
        RewriteRule /(.*) ws://localhost:8080/socket.io/$1 [P,L]
        # Adjust the WebSocket path according to your Socket.IO configuration
        # For Socket.IO 3.x or higher, use /socket.io/?EIO=4&transport=websocket
    </Location>
</VirtualHost>

Bash

# Check configuration
sudo apache2ctl configtest

sudo a2enmod proxy # Enables the `mod_proxy` module, which is essential for proxying HTTP and WebSocket connections.
sudo a2enmod proxy_http # Enables the `mod_proxy_http` module, which adds support for proxying HTTP connections.
sudo a2enmod proxy_wstunnel # Enables the `mod_proxy_wstunnel` module, which provides support for tunneling WebSocket connections

# Restart apache
sudo systemctl restart apache2

Updating Your Instance

To keep your MiroTalk C2C instance up to date, create an update script:

Bash

$ cd
# Create a file c2cUpdate.sh
$ vim c2cUpdate.sh

For PM2:

Bash

#!/bin/bash

cd mirotalkc2c
git pull
sudo npm ci
pm2 restart backend/server.js

For Docker:

Bash

#!/bin/bash

cd mirotalkc2c
git pull
docker-compose down
docker-compose pull
docker image prune -f
docker-compose up -d

Make the script executable:

Bash

$ chmod +x c2cUpdate.sh

To update your MiroTalk C2C instance to the latest version, run the script:

Bash

./c2cUpdate.sh

Was this article helpful?

Da Nu