Skip to main content

Use a container image

  1. Pull the latest version from Dockerhub: docker pull owncast/owncast:latest.
  2. Run docker run -v `pwd`/data:/app/data -p 8080:8080 -p 1935:1935 owncast/owncast:latest to start the service.
  3. This will bind the data directory so you have access to backups and your database in case you need to move it to another server.

Alternatively, you can create a docker-compose.yml file with the following contents:

version: "3"
services:
owncast:
image: owncast/owncast:latest
ports:
- "8080:8080"
- "1935:1935"
volumes:
- ./data:/app/data

and run docker compose up to start the 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

DefaultValue
Admin usernameadmin
Admin passwordabc123
Stream keyabc123

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

  1. Point your broadcasting software at your new server using rtmp://yourserver/live with your stream key. If your software doesn't have a way to specify a stream key use the url rtmp://yourserver/live/streamkey and use your stream key instead.
  2. Access your server in your web browser by visiting http://yourserver:8080.
  3. You can visit the Admin dashboard at http://yourserver:8080/admin where you can check visitor and server stats, change your stream key, personalize the content displayed on your page, and more. To login, use admin and 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.

Contributors to this page

Related Documents