Linux - Download and Install Guide

Install Feihan Server from the Linux server package, then complete initialization in a browser.

Download and start

  1. Open the Feihan Server download page approved by your organization.
  2. Download the Linux Server package.
  3. Extract the archive.
  4. Open a terminal in the extracted directory and run:
./feihan run
  1. Wait until the terminal shows Web service is running.

Server Running in Terminal

Copy an initialization URL from the terminal and open it in a browser.

Open Initialization URL

Initialize Feihan Server

  1. In the setup wizard, select the server version and upload your Feihan license file (.fhl).
Tip

A valid license is required before the server can be initialized.

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. Wait for server initialization to finish.

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.

Run as a systemd service

To start Feihan Server automatically at boot, place the server files in /usr/local/feihan and create /etc/systemd/system/feihan.service:

[Unit]
Description=Feihan Server
After=network.target

[Service]
Type=simple
WorkingDirectory=/usr/local/feihan
ExecStart=/usr/local/feihan/feihan run
Restart=on-failure
RestartSec=5
LimitNOFILE=1048576
LimitCORE=infinity

[Install]
WantedBy=multi-user.target

Then run:

sudo systemctl daemon-reload
sudo systemctl enable --now feihan
sudo systemctl status feihan