Installation
By using the installer you can get up and running in about a minute. However, if you would prefer to download a release manually, use a one-click install at a supported hosting provider, or other methods visit the Installation page to find the installation method that best matches your needs.
Installer
Paste the following into your shell and the installer will download the most recent version of Owncast for your platform. It will also download a copy of ffmpeg if you don't currently have one installed.
curl -s https://owncast.online/install.sh | bash
Note: It is not suggested you run this as root, as you're downloading and running a script off the internet. It's also recommended you inspect the contents of any remote script before executing it.
See an example of getting running in under a minute.
That's it!
While the above installer will be enough for most people to get up and running quickly, you may want to learn about server configuration, broadcasting, and optional next steps such as SSL proxies and running Owncast as a system service.
Login to the admin and set up your stream
The admin interface can be found by navigating to /admin on your Owncast server (e.g., https://owncast.example.com/admin).
Configuring your broadcasting software to stream to your Owncast server requires you to use the /live endpoint along with providing the stream key. (e.g., rtmp://owncast.example.com/live with stream key abc123). If your software does not allow specifying the stream key separately, you may need to append it to the URL as rtmp://owncast.example.com/live/abc123.
Default credentials
| Default | Value |
|---|---|
| Admin username | admin |
| Admin password | abc123 |
| Stream key | abc123 |
These are the default credentials for logging into the Owncast admin interface and streaming to your Owncast server. It is highly recommended that you change these values immediately after your first login to ensure the security of your server.
Next steps
- Point your broadcasting software at your new server using
rtmp://yourserver/livewith your stream key. If your software doesn't have a way to specify a stream key use the urlrtmp://yourserver/live/streamkeyand use your stream key instead. - Access your server in your web browser by visiting
http://yourserver:8080. - You can visit the Admin dashboard at
http://yourserver:8080/adminwhere you can check visitor and server stats, change your stream key, personalize the content displayed on your page, and more. To login, useadminand the stream key as the password.
Note: Your stream key is only used by your streaming software to publish video; it is not your admin password.
Manual Installation
- 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.
- Run
./owncastto start the service. - Visit the admin at
/adminto configure your server using the usernameadminand the default stream key as the password,abc123.
The admin interface can be found by navigating to /admin on your Owncast server (e.g., https://owncast.example.com/admin).
Configuring your broadcasting software to stream to your Owncast server requires you to use the /live endpoint along with providing the stream key. (e.g., rtmp://owncast.example.com/live with stream key abc123). If your software does not allow specifying the stream key separately, you may need to append it to the URL as rtmp://owncast.example.com/live/abc123.
Default credentials
| Default | Value |
|---|---|
| Admin username | admin |
| Admin password | abc123 |
| Stream key | abc123 |
These are the default credentials for logging into the Owncast admin interface and streaming to your Owncast server. It is highly recommended that you change these values immediately after your first login to ensure the security of your server.
Next steps
- Point your broadcasting software at your new server using
rtmp://yourserver/livewith your stream key. If your software doesn't have a way to specify a stream key use the urlrtmp://yourserver/live/streamkeyand use your stream key instead. - Access your server in your web browser by visiting
http://yourserver:8080. - You can visit the Admin dashboard at
http://yourserver:8080/adminwhere you can check visitor and server stats, change your stream key, personalize the content displayed on your page, and more. To login, useadminand the stream key as the password.
Note: Your stream key is only used by your streaming software to publish video; it is not your admin password.
