Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Livestream (Live Video) has the feature to live from directly built-in devices on your computer without the streaming software's support. Furthermore, this new feature still leverages Mux and its features to provide a smooth experience for users. In this article, we will guide you to set up the transcoder server to enable this feature.

Requirements

  • Dedicated server/VPS/cloud server for transcoder server
  • At least 8G RAM, 4 vCPUs
  • Live ideo app version 5.1 or later.

Transcoder server setup

Firstly, the transcoder server had been built and pushed to DockerHub at https://hub.docker.com/r/foxsystem/metafox-transcoder-livevideo. Therefore, you can update docker-compose.yml to have a new service - "transcoder" as below. 
docker-compose.yml


Code Block
version: '3'
 
services:
    ...
    transcoder:
        container_name: metafox-transcoder
        image: foxsystem/metafox-transcoder-livevideo:latest
        restart: always
        tty: true
        volumes:
            - ./upload:/app/upload
        ports:
            - ${WS_EXTERNAL_PORT:-3001}:${WS_PORT}
        env_file:
            - .env
        networks:
            - metafox-app-tier


Moreover, to make the server operate correctly, you also have to update your .env to adapt a few variables that the server needs
.env

Code Block
WS_PORT=3000
WS_EXTERNAL_PORT=30003001
NODE_ENV=production
JWT_SECRET=transcoderSecret
MFOX_BASE_API_URL=https://yourdomain/api/v1


Given that,

  • WS_PORT and WS_EXTERNAL_PORT: defining the internal and external WebSocket server ports.  
  • NODE_ENV: configures running mode for better performance.
  • JWT_SECRET: is the key used for signing and verifying JSON Web Tokens (JWTs). You can set to any random string.
  • MFOX_BASE_API_URL: specifies the API URL of MetaFox.

Finally, you can just restart the docker to apply new service by using command

Code Block
docker-compose up -d

MetaFox setup

Now, let's go to AdminCP of MetaFox to configure Live Video with the transcoder server. Visit AdminCP > App Settings > Live Videos > Settings and configure two settings: Allow Webcam Streaming and Transcoder Server Url (see in image below).

Image Modified

Given that,

  • Allow Webcam Streaming: turn on if you want to allow streaming using webcam.
  • Transcoder Server Url: the URL of transcoder webserver.