Take control over your live stream video by running it yourself. Streaming + chat out of the box.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Go to file
Owncast bcc0531dcb
Commit screenshots
19 hours ago
.design chore(docs): update docs to reflect font change 5 months ago
.github chore(deps): update peter-evans/create-or-update-comment digest to 46da6c0 1 week ago
.vscode chore: remove vscode config file 3 months ago
activitypub fix: verify object and actor exists in Like request. Closes #3223 (#3232) 2 months ago
auth Update to Go 1.20 + run better align (#2927) 4 months ago
build Add offline option to bundle web.sh (#3202) 1 week ago
config chore: bump version number to 0.1.2 2 months ago
contrib Update to Go 1.20 + run better align (#2927) 4 months ago
controllers feat(chat): add support for chat part messages. Closes #3201 (#3291) 3 weeks ago
core fix: remove whitespace to resolve linter warning 1 week ago
db Check if proposed name change is an API name (#3256) 2 months ago
docs fix(docs): fix typo in release doc. Closes #3066 4 months ago
geoip refactor geoip (#1442) 2 years ago
logging Expanded linting + fix warnings (#1396) 2 years ago
metrics Update to Go 1.20 + run better align (#2927) 4 months ago
models feat(storage): support a object storage custom path prefix 2 months ago
notifications Guard against invalid push server response as an addition check for #2855 6 months ago
router feat: simplify console logs 4 months ago
static Bundle embedded web app 1 week ago
test Bump fast-xml-parser and artillery in /test/load (#3300) 3 weeks ago
utils Block Private URLs at `serverurl` API endpoint (#3295) 3 weeks ago
web Commit screenshots 19 hours ago
yp Update to Go 1.20 + run better align (#2927) 4 months ago
.editorconfig Update EditorConfig with some explicit settings 1 year ago
.gitattributes Update gitattributes file 8 months ago
.gitignore chore: add support for exporting our colors as Swift files 3 months ago
.gitpod.yml Add Gitpod config (#2173) 12 months ago
.golangci.yml Update to Go 1.20. Closes #2185 4 months ago
.prettierignore Added moderator menu to messages and some other styling. 1 year ago
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 3 years ago
CONTRIBUTING.md Create CONTRIBUTING.md (#1394) 2 years ago
Dockerfile chore(deps): update alpine docker tag to v3.18.3 2 months ago
Earthfile fix: export correct timestamps on build artifacts. Closes #3282 1 month ago
LICENSE Update LICENSE to be current (#3058) 4 months ago
README.md Update to Go 1.20 + run better align (#2927) 4 months ago
go.mod fix(deps): update module github.com/aws/aws-sdk-go to v1.45.14 1 week ago
go.sum fix(deps): update module github.com/aws/aws-sdk-go to v1.45.14 1 week ago
main.go Add details to temp dir removal error 9 months ago
openapi.yaml Update OpenApi spec to reflect v0.1.0. For #2431 8 months ago
renovate.json Remove references to webv2 branch in docs and builds 8 months ago
sqlc.yaml Messages table fixes to improve query performance (#2026) 1 year ago



Take control over your content and stream it yourself.
Explore the docs »
View Demo · Use Our Server for Testing · FAQ · Report Bug

Table of Contents

About The Project

Owncast is an open source, self-hosted, decentralized, single user live video streaming and chat server for running your own live streams similar in style to the large mainstream options. It offers complete ownership over your content, interface, moderation and audience. Visit the demo for an example.

Getting Started

The goal is to have a single service that you can run and it works out of the box. Visit the Quickstart to get up and running.

Use with your existing broadcasting software

In general, Owncast is compatible with any software that uses RTMP to broadcast to a remote server. RTMP is what all the major live streaming services use, so if youre currently using one of those its likely that you can point your existing software at your Owncast instance instead.

OBS, Streamlabs, Restream and many others have been used with Owncast. Read more about compatibility with existing software.

Building from Source

Owncast consists of two projects.

  1. The Owncast backend is written in Go.
  2. The frontend is written in React.

Read more about running from source.

Important note about source code and the develop branch

The develop branch is always the most up-to-date state of development and this may not be what you always want. If you want to run the latest released stable version, check out the tag related to that release. For example, if you'd only like the source prior to the v0.1.0 development cycle you can check out the v0.0.13 tag.

Note: Currently Owncast does not natively support Windows servers. However, Windows Users can use Windows Subsystem for Linux (WSL2) to install Owncast. For details visit this document.


The Owncast backend is a service written in Go.

  1. Ensure you have prerequisites installed.
  2. Install the Go toolchain (1.20 or above).
  3. Clone the repo. git clone https://github.com/owncast/owncast
  4. go run main.go will run from the source.
  5. Visit http://yourserver:8080 to access the web interface or http://yourserver:8080/admin to access the admin.
  6. Point your broadcasting software at your new server and start streaming.


The frontend is the web interface that includes the player, chat, embed components, and other UI.

  1. This project lives in the web directory.
  2. Run npm install to install the Javascript dependencies.
  3. Run npm run dev


Owncast is a growing open source project that is giving freedom, flexibility and fun to live streamers. And while we have a small team of kind, talented and thoughtful volunteers, we have gaps in our skillset that wed love to fill so we can get even better at building tools that make a difference for people.

We abide by our Code of Conduct and feel strongly about open, appreciative, and empathetic people joining us. Weve been very lucky to have this so far, so maybe you can help us with your skills and passion, too!

There is a larger, more detailed, and more up-to-date guide for helping contribute to Owncast on our website.


Distributed under the MIT License. See LICENSE for more information.

Supported by


Project chat: Join us on Rocket.Chat if you want to contribute, follow along, or if you have questions.

Gabe Kangas - @gabek@social.gabekangas.com - email gabek@real-ity.com

Project Link: https://github.com/owncast/owncast