Building from Source #

  1. Ensure you have the gcc compiler configured.
  2. Install the Go toolchain.
  3. Clone the repo. git clone
  4. Follow the above Getting Started instructions, making sure ffmpeg exists and your config file is set.
  5. Make any configuration changes.
  6. go run main.go pkged.go will run the application.

Using Docker #

  1. Download the code: git clone
  2. Copy config-default.yaml to config.yaml
  3. Edit config.yaml with a file editor of your choice and change the path of ffmpeg by appending ffmpegPath: /usr/bin/ffmpeg at the top level of the yaml.
  4. Make any configuration changes.
  5. If you ever make any future config file changes you must rerun the docker build step otherwise you can just run the docker run step to run the service going forward.
  6. Run docker build -t owncast . and wait. It may take a few minutes to build depending on the speed of your server.
  7. Run docker run -p 8080:8080 -p 1935:1935 -it owncast to start the service.