• English

      • Docker - Deployment Guide

      Deploy Feihan Server as a Docker container, then finish setup in the browser-based initialization wizard.

      Quick start container

      Run the following command on the Docker host:

      docker run -d \
  --name feihan-server \
  -p 21000:21000 \
  -p 27881:27881 \
  -p 27882:27882/udp \
  --restart always \
  feihanim/server:latest

      The container exposes these service ports:

      • 21000 (TCP): core service (HTTP API / WebSocket)
      • 27881 (TCP): RTC media fallback
      • 27882 (UDP): RTC media transport

      To keep configuration and data outside the container, mount host directories at /app/config and /app/data:

      docker run -d \
  --name feihan-server \
  -p 21000:21000 \
  -p 27881:27881 \
  -p 27882:27882/udp \
  -v ./config:/app/config \
  -v ./data:/app/data \
  --restart always \
  feihanim/server:latest

      Initialize Feihan Server

      1. Open http://localhost:21000 in a browser. In the initialization wizard, select the server version and upload your Feihan license file (.fhl).
      Tip

      When opening the wizard from another computer, replace localhost with the Docker host name or IP address.

      Initialize Server

      1. Set the organization avatar and create the super administrator account, then click Next.
      Tip

      Store the super administrator username and password securely. You can also use this account to sign in to a Feihan client.

      Set Super Admin

      1. Review the remaining organization settings and continue.

      Organization Settings 1

      Organization Settings 2

      1. Keep the container running while initialization completes.

      Wait for Initialization

      Initialization complete

      1. When initialization finishes, Feihan opens Admin Console.

      Admin Console Overview

      Sign in to clients

      After the server is ready, continue with the client installation and sign-in guide.