<img src="https://owncast.online/images/logo.png" alt="Logo" width="200">
<strong>Take control over your content and stream it yourself.</strong>
<br />
<a href="https://owncast.online"><strong>Explore the docs »</strong></a>
<br />
<a href="https://watch.owncast.online/">View Demo</a>
·
<a href="https://broadcast.owncast.online/">Use Our Server for Testing</a>
·
<a href="https://owncast.online/faq/">FAQ</a>
·
<a href="https://github.com/owncast/owncast/issues">Report Bug</a>
Note: Owncast currently does not support Windows Operating System. This is a workaround to run Owncast on Windows.
This document list out the steps in detail to install and run Owncast in Windows using Windows Subsystem for Linux, specifically WSL2.
The steps provided are for both the use cases whether you want to use Owncast or build and install Owncast for contributing to the project.
There are lots of tutorials available online (videos and docs both) on how to install WSL2.
Here are the official documents from Microsoft -> Install Linux on Windows with WSL
Some points to remember ->
wsl --install
. If you are facing issues with this method you can look at - Manual installation steps for older versions of WSLAfter basic setup, you can look into setting WSL2 for development. Here is the link for a detailed document by Microsoft - https://learn.microsoft.com/en-us/windows/wsl/setup/environment
One of the many ways to install Owncast is to use the Quick Installer script. In the WSL2 terminal run, the following command
curl -s https://owncast.online/install.sh | bash
cd owncast
./owncast
If everything is installed correctly you will be able to access the admin interface at port localhost:8080/admin
.
Here are other ways listed you can use to install Owncast -Owncast Quickstart
If you face any errors you can look at the Error List at the end of the document.
Here is the list for all the prerequisites required ->
sudo apt install npm
.sudo apt install nodejs
.These steps are for building and install Owncast on Windows for development and contributing to this project.
The Owncast backend is a service written in Go.
git clone https://github.com/owncast/owncast
go run main.go
will run from the source.http://yourserver:8080
to access the web interface or http://yourserver:8080/admin
to access the admin.The frontend is the web interface that includes the player, chat, embed components, and other UI.
web
directory.npm install
to install the Javascript dependencies.npm run dev
Further information about the development is here
You can contribute to Owncast here https://github.com/owncast/owncast
You have an older version of Nodejs installed in the WSL2.
To solve this issue you can look at nvm. Here is one tutorial - Node-Version-Manager.
The broadcasting Software failed to connect to the server.
This issue arises when you try to use rtmp://localhost:1935/live
for example in OBS.
To solve this issue you need to find the correct IP address for the WSL2 you are running and use that instead of localhost.
You can use the below commands to find that ->
Note: you can use either of these, whichever works for you.
ip addr show eth0 | grep -oP '(?<=inet\s)\d+(\.\d+){3}'
wsl -- ip -o -4 -json addr list eth0
In this result look for "local": X.X.X.X
After finding the IP address in your broadcasting software make the server point to
rtmp://<your version of IP address>:1935/live
Now check again, you will be able to stream.
Thanks for installing Owncast if you face any problems. You can contact here.
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