Building

Building from Source #

  1. Ensure you have the gcc compiler configured.
  2. Install the Go toolchain.
  3. Clone the repo. git clone https://github.com/gabek/owncast
  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 on the first run will download the required packages needed for the application to build.
  7. It will start running the same as in the above Usage instructions and you can point OBS to your localhost instance of it.

Using Docker #

  1. Download the code: git clone https://github.com/gabek/owncast
  2. Copy config-example.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.