Installation Guide

LiveGo is designed for easy installation. You can get started by using a pre-compiled binary, building from source, or running a Docker container.

From Pre-compiled Binaries

The easiest way to install LiveGo is to download a pre-compiled binary for your operating system from the official GitHub Releases page.

Based on the .goreleaser.yml configuration, binaries are available for:

  • Windows (386, amd64)
  • macOS (amd64)
  • Linux (386, amd64, arm)
  • FreeBSD (386, amd64)

After downloading the appropriate archive for your system, extract the livego (or livego.exe) binary and run it from your terminal.

From Source

If you prefer to build from source, you'll need to have a Go environment (version 1.13 or newer) set up.

  1. Clone the repository:

    git clone https://github.com/gwuhaolin/livego.git
cd livego

  2. Build the binary:

The project includes a Makefile that simplifies the build process. You can use either the standard Go build command or the make command.

  • Using Make (recommended): 
    make build
  • Using Go command: 
    go build -o livego ./main.go

This will create a livego executable in the project directory.

Using Docker

A Docker image is available for a convenient, containerized setup.

  1. Pull the image: The official image is hosted on Docker Hub.

    docker pull gwuhaolin/livego

  2. Run the container: The following command will start the LiveGo server and map the necessary ports to your host machine.

    docker run -d --name livego-server \
  -p 1935:1935 \
  -p 7001:7001 \
  -p 7002:7002 \
  -p 8090:8090 \
  gwuhaolin/livego
    This maps the following default ports:

    • 1935: RTMP
    • 7001: HTTP-FLV
    • 7002: HLS
    • 8090: HTTP API

For a more detailed guide on deploying with Docker, including custom configurations, see the Deployment with Docker page.