The installer #
Paste the following into your shell and the installer will download Owncast for you.
curl -s https://owncast.online/install.sh | bash
If you would prefer to download a release manually or use Docker you have some other options.
Manually download and run a release #
You can choose between downloading a zip file of Owncast, or using Docker.
Download and run a release #
ffmpegif you haven’t. Use version 4.1.5 or above.
- Make a directory to run the service from, and download a release from https://github.com/owncast/owncast/releases into that directory.
- Unzip the release.
config.yamlas detailed below.
./owncastto start the service.
Use a Docker image #
- Pull the
latestversion from Dockerhub:
docker pull gabekangas/owncast:latest.
docker run -p 8080:8080 -p 1935:1935 -it gabekangas/owncast:latestto start the service.
- To modify the configuration, you can take a blueprint from the docs and save it to ˋconfig.yamlˋ. Then, bind the file inside docker:
docker run -v `pwd`/config.yaml:/app/config.yaml -p 8080:8080 -p 1935:1935 -it gabekangas/owncast:latest.
A computer that’s on the public internet to run it on. While crunching through video and serving it to viewers can be intensive from the computing side, you can get away with pretty meager resources on a simple setup. If you don’t already have a server to run it on you can get a Linode instance for $5/mo that runs it fine. If you worry that you’ll be maxing out the bandwidth or transfer limits allotted to you, then utilize S3 Storage very cheaply (or even free for a certain amount) to serve the files instead.
ffmpegneeds to be available on your machine. If you use the above installer it will try to download a copy of ffmpeg for you if needed, and the Docker image already contains it for you. Note: The Snap package of ffmpeg is not compatible with Owncast.
config.yamland change your stream key.
- Continue to edit the config file and customize with your own details, links and info. See More Configuration to find additional ways to configure video quality.
- Point your broadcasting software at your new server using
rtmp://yourserver/liveand the stream key you set above and start your stream.
- Access your server in your web browser by visiting
- You can visit the Admin dashboard at
http://yourserver:8080/adminwhere you can check visitor and server stats. To login, use
adminand the stream key as the password.