▶Stream4US

Tutorial

Step by step, from the first sign-in to a full Sunday, then the rest of the week.

This tutorial walks you through castgate from the first sign-in to a complete Sunday, and then through the rest of the week. Part 1 is for churches and channels (owners and team members). Part 2 is for the administrator who runs the server. Every step says where to click; the feature reference describes each feature in more detail, and troubleshooting helps when something does not work.

Part 1: for churches and channels

Step 1. Create your account

  1. Open the sign-up link your provider gave you, or the server's home page, and choose Start.
  2. Enter the signup code you received, your church's name, your email and a password (at least 8 characters).
  3. Choose your web address (for example grace-church). Your page will be https://your-server/c/grace-church. Use letters, numbers and dashes; you can add your own domain later.
  4. Accept the terms and sign up. You land on Getting started, a checklist that ticks itself off as you go.
Protect your login now: open Security at the top of the page and turn on two-step sign-in with an authenticator app (Google Authenticator, Microsoft Authenticator, Authy or 1Password). Keep the ten recovery codes somewhere safe.

Step 2. Settings: name, logo, color, time zone

Open Settings in the dashboard menu.

  1. Name and about: shown on your page and in the TV apps.
  2. Time zone: important. Schedules, the weekly grid, statistics and "Up next" use it.
  3. Logo (a square PNG or JPG works best) and brand color: used on your page, in the player and in the TV apps.
  4. Website and giving link: shown as buttons on your page and in the apps.
  5. Categories: the choices for sorting recordings, for example Sunday Service, Bible Study, Youth.
  6. Record (always, only scheduled events, or never) and Publish automatically (recordings appear on your page without review).
  7. Save. Your page already shows your name, logo and "offline" until you go live.

Step 3. Choose how to send video

You send one stream to castgate; castgate does the rest. Pick the way that fits your equipment:

You haveUseWhere
OBS, vMix, Wirecast, a hardware encoder (ATEM Mini Pro, Teradek, Magewell)RTMP or SRTOverview page: server address and stream key
A USB camera or capture card on a computer, no encoder softwareThe castgate desktop sender (Windows, Mac, Linux)Overview page → Desktop sender
Only a laptop or phoneGo live from the browserGo live
A recorded videoUpload, then play it as live or on the 24/7 channelRecordings → Upload

OBS in detail

  1. In OBS open Settings → Stream. Service: Custom.
  2. Server: the RTMP address from your Overview page (for example rtmp://live.example.com/live). Stream key: copy it with the Copy button.
  3. Settings → Output (advanced mode): encoder x264 or your graphics card, rate control CBR, bitrate 2,500 kbps for 720p or 4,500 kbps for 1080p, keyframe interval 2 seconds, audio AAC 128 kbps or 160 kbps.
  4. Settings → Video: 1280×720 or 1920×1080, 30 fps.
  5. Press Start Streaming. Within a few seconds the Overview page turns red ("Live") and shows the bitrate and picture size.

SRT is better on poor or busy internet connections (it repairs lost packets). In OBS or vMix use the SRT address shown on the Overview page (it already contains your key). The church firewall must allow outgoing UDP to port 9000.

Several qualities: viewers on slow connections get a smooth picture if you send 1080p, 720p and 480p (vMix, OBS with several outputs, or the desktop sender does this for you), or if your plan includes "lower qualities made on the server". See several qualities.

Step 4. Your weekly schedule

Open Schedule.

  1. Add your regular service, for example "Sunday Service, Sundays 10:30, 90 minutes", repeating weekly. Your page then shows "Next live: Sunday 10:30" with a countdown.
  2. Add special events (Christmas Eve, a wedding, a funeral). Tick Private for an event that needs an access code; give the code to the family.
  3. Each event can have a title, category and speaker that the recording takes automatically.
  4. Replay as live: schedule a recording to play at a set time as if live (useful for a second service time or another time zone).

Step 5. Your first live service

  1. Start your encoder 5 to 10 minutes before the service. Check the Overview page: Live, bitrate stable, picture size as expected.
  2. Open your page (/c/your-address) on a phone with mobile data, not the church Wi-Fi, to see what viewers see. A delay of 10 to 20 seconds is normal.
  3. Viewers who join late can rewind to the beginning ("Watch from the start") and catch up.
  4. Watch Audience → Right now during the service: viewers, countries, cities and devices update every few seconds.
  5. When the service ends, stop the encoder. The recording is closed automatically after 90 seconds (in case the encoder only lost the connection briefly).

Step 6. Share and embed

  1. Share your page link by text message, email, the church bulletin or social media.
  2. To show the player on your own website, copy the embed code (Overview page) and paste it into your website editor (WordPress: a "Custom HTML" block; Squarespace and Wix: an "Embed" or "Code" block).
  3. Your page also has a link for podcast apps, a radio stream and links for TV apps (see the next steps).

Step 7. YouTube and Facebook at the same time (restream)

  1. Open Restream and add a destination: choose YouTube, Facebook or "Other RTMP", paste the stream URL and key you get from YouTube Studio or Facebook Live Producer.
  2. Tick On. When you go live, castgate sends your stream to every destination that is on; your upload carries only one stream.
  3. The page shows each destination's status. If one shows an error, the key probably changed on their side: paste the new one.

Step 8. Chat, prayer requests and live captions

  1. Chat: switch it on so viewers can greet each other (no account needed). Choose "open only while live", slow mode, blocked words, translation into each viewer's language (when the administrator set up a translation server), and whether the TV apps show it. Remove messages or block a writer from the Chat page.
  2. Prayer: tick "Show a Prayer request button on your page". Requests arrive in the Prayer inbox (never shown publicly) and by email to the address you choose. Mark them "Prayed for".
  3. Live captions: on the Chat page, when the administrator connected a transcription server, choose the spoken language. Viewers press CC to see captions during the stream; afterwards they are kept with the recording. Since 1.3 the captions are also inside the stream, so iPhones (in full screen too), the Android TV and Fire TV app and Roku show them in their own caption menu or setting. While live captions are on, viewers watch about 30 seconds behind live so each caption appears with its picture.

Step 9. After the service: the recording

Open Recordings. The service is at the top.

  1. Open it. Use the editor to trim the start and end (drag the handles or type the times) and cut parts in the middle (announcements, a song without rights). Nothing is lost: cuts can be undone.
  2. Fill in title, speaker, series, scripture, tags and description. Choose the thumbnail (pick a frame).
  3. Captions: upload a .vtt or .srt file, or press Make captions automatically (needs a transcription server). Captions can be translated.
  4. Qualities: press Make 720p, 480p and 360p for viewers on slow connections.
  5. Download: allow viewers to download the MP4 if you want.
  6. Choose Published (on your page), Draft (only you) or Private (with a password), and save.
  7. Every recording has its own links: a page, an embed code, an HLS link for apps and VLC, and entries in your feeds.

To prepare many at once, tick several recordings on the Recordings page and choose a bulk action (publish, category, playlist, download, qualities, delete).

Upload videos you already have: Recordings → Upload (many files at once, up to 20 GB each) or Add a video from a link (direct link, Dropbox or Google Drive).

Step 10. During the week: 24/7 and the weekly grid

  1. Open 24/7 and choose what plays when you are not live: your playlist, all published recordings, or one category, newest first, oldest first or shuffled. Live always takes over by itself and the recordings come back 30 seconds after you stop. Optional: under "Up next" cards, tick Show a card before each recording. Each recording then starts with a short card (8 seconds unless you change it) with your logo, color and the title, so people who tune in between two recordings see what is coming. Upload a logo and pick a color in Settings first; the preview shows the result.
  2. Open Weekly grid to put programs at fixed times, like a TV station: tick the days, choose the start time and what plays (one recording, a category, the playlist, everything) and how long. At a block's start the channel switches to it on time; between blocks the 24/7 rotation plays (or nothing if 24/7 is off).
  3. Your page and the TV apps show "Now playing" and "Up next" with the times.

Step 11. Podcast and radio

  1. Open Podcast & radio. Turn on the podcast: castgate makes an audio podcast from your published recordings (choose all or one category, cover art, author, explicit flag).
  2. Copy the podcast feed address and submit it once to Apple Podcasts (Podcasts Connect) and Spotify (Spotify for Creators). New recordings then appear in their apps automatically.
  3. Turn on the radio stream: an MP3 stream of your live sound (or the 24/7 channel) for TuneIn, radio apps, smart speakers and VLC. Radio apps show what is playing.

Step 12. TV apps

  1. Under Settings tick Show this channel in the castgate TV apps to appear in the directory of the castgate app on Roku, Fire TV and Android TV. Viewers search for your name.
  2. For an app with your own name and logo, open TV apps and download your Roku package and Android source kit (the README in it explains building and publishing). Your logo, color and announcement update in the apps without a new version.
  3. To try it today on a Fire TV or Android TV: install the ready-made app with the Downloader app (address on the TV apps page), type the server address and your channel once.
  4. In the apps: Watch live, Watch from the start, Up next, your recordings by category, a read-only chat over the live picture (* on Roku, menu button on Fire TV hides it) and your giving link.

Step 13. Audience

Open Audience after the service:

  • Viewers, unique viewers, people who came back, hours watched, average minutes, most at once and your all-time record.
  • Viewers per day, watching at the same time, when they tune in, countries, states and cities, a map, devices, browsers and apps, internet providers, what they watched, and where the player was embedded (your website, Facebook...).
  • The globe and When they watch (weekday by hour) are 3D: drag them to turn them, point at a column or bar for its numbers. The amber bars are your busiest hours, a good guide for when to schedule.
  • Audience retention shows where people stop watching your recordings; What they watched shows how far into each recording they got.
  • Playback quality shows how fast video starts and how often it stopped, per internet provider. If one provider is much worse than the others, the problem is on that network, not your stream.
  • Compare with the previous period, choose any date range, and export CSV. Owners can receive a weekly report by email on Monday mornings.

Who may watch. If your stream is only for your area or your members' country, open Settings → Who may watch and fill in the countries, networks or cities to allow (or to block). Press Check an address with a viewer's address to see where it is and whether it may watch.

Peer-to-peer. If your administrator allows it, turn on Settings → Peer-to-peer playback: viewers then pass the video to each other, and the Audience page shows how much of the video came from viewers instead of the server.

Step 14. Your team and more channels

  1. Team: add volunteers with their email and a password. Members can stream, edit recordings and see the audience; only the owner changes settings, keys and the team.
  2. Channels: on plans with more than one channel, the owner adds channels (a Spanish service, a youth channel, a radio station). Each has its own key, page, recordings and statistics; switch with the Channel menu at the top.
  3. Your own web address: in Settings enter a name such as live.gracechurch.org, then create a DNS record pointing to the server (the page shows exactly which). The certificate is made automatically.

Step 15. Billing

If your provider sells castgate online, Billing (owners only) shows your plan, whether it is paid and until when. Manage subscription opens the billing site (payment method, invoices, cancel); Change plan opens the checkout of another plan, linked to your account. If a payment fails you get an email and a grace period before the account pauses; it resumes by itself when the payment arrives.

Step 16. A Sunday checklist

  • [ ] Encoder on and streaming 10 minutes early; Overview shows Live and a stable bitrate.
  • [ ] Page checked on a phone using mobile data.
  • [ ] Chat open; someone greets viewers.
  • [ ] Restream destinations green.
  • [ ] After the service: trim, add speaker and scripture, publish.
  • [ ] Monday: look at Audience and share the recording link.

Part 2: for the administrator

Step 1. A server

  • Ubuntu 22.04 or 24.04 (or another Linux), 4 CPU cores and 8 GB of memory carry hundreds of live churches because castgate does not re-encode by default. Plan one core per church that uses "Go live" in the browser, uploads with re-encoding or server-made qualities.
  • Disk: recordings take about 1 GB per hour at 2,500 kbps. Start with 500 GB to 2 TB.
  • Network: a public IPv4 address; viewers multiply outgoing traffic (100 viewers × 2.5 Mbps = 250 Mbps). Use a CDN in front for large audiences.
  • Open TCP 80 and 443, UDP 443 (HTTP/3), TCP 1935 (RTMP) and UDP 9000 (SRT).

Step 2. Install

sudo useradd --system --home /var/lib/castgate --shell /usr/sbin/nologin castgate
sudo install -m 755 castgate-linux-amd64 /usr/local/bin/castgate
sudo apt install ffmpeg
sudo cp castgate.service /etc/systemd/system/
sudo nano /etc/systemd/system/castgate.service     # set -domain and -acme-email
sudo systemctl daemon-reload && sudo systemctl enable --now castgate
journalctl -u castgate -f

Create a DNS A record (and AAAA for IPv6) for your domain pointing to the server before the first start, so the certificate can be issued.

Step 3. The first administrator

The log shows FIRST RUN: create the administrator at /setup?token=.... Open that address and create the administrator. Then turn on two-step sign-in under Security, and under Admin → Settings tick "Require two-step sign-in for administrators".

Step 4. Email

Admin → Settings → Email: choose your mail service (Gmail, Microsoft 365, SMTP2GO, Brevo, Amazon SES, Mailgun, or this server), enter the user and password, the From address, and press Send a test email. The email setup guide explains each service step by step.

Step 5. Plans and signup codes

  1. Admin → Plans: prices and limits (viewers at once, storage, rewind hours, archive days, restream destinations, 24/7, server-made qualities, private events, uploads, channels per login). Plans marked public appear on the home page.
  2. Admin → Signup codes: create a code with a plan, optional trial days, number of uses and expiry. Give it to the church.
  3. Admin → Accounts: change a church's plan or limits, suspend with a reason they see, open their dashboard to help them, or delete.

Step 6. Home page, TV apps, AI services

  • Admin → Home page: headline, text, feature cards, questions, contact details, legal pages, colors.
  • Admin → TV apps: every church's app settings; download Roku packages and Android kits, and the universal apps for testing.
  • Admin → Settings: a streaming address for a CDN, translation (LibreTranslate) and transcription (OpenAI-compatible) servers for chat translation and captions, encoder choice (processor or graphics card), segment length, weekly reports.
  • Admin → Blocking → Countries, networks and cities: blocks for the whole server (needs the GeoIP databases).
  • Admin → Peer-to-peer: allow channels to use peer-to-peer playback, turn on the built-in relay (open its ports, then press Test STUN and TURN), and optionally set outside STUN and TURN servers (a coturn server with a shared secret works). If a reverse proxy is in front of castgate, it must pass WebSocket upgrades for /p2p/ws.

Step 7. Sell plans online (optional)

To sell castgate on a billing site such as encrypted.com instead of handing out signup codes: Admin → Billing, turn it on, give the billing site the webhook address and shared secret, enter each plan's checkout link, and press Send a test event. New customers then pay on your home page and receive their sign-up link by email; renewals, failed payments and cancellations are applied to their accounts automatically. The billing integration guide has the steps and the exact format for the billing site's developers.

Step 8. Watch, back up, update

  • Admin → System: CPU, memory, disk, traffic, simultaneous connections, live streams, viewers, and setup checks with exact fixes. Admin → Audit log: who changed what.
  • Monitoring: /metrics for Prometheus (token on the System page).
  • Backups: castgate copies its settings to backups/ in the data folder every day (14 days kept). Back up the whole data folder (recordings included) to another machine regularly.
  • Update: replace /usr/local/bin/castgate and sudo systemctl restart castgate. Streams reconnect by themselves within seconds; recordings continue.

See running in production for the full checklist.

This guide is also in the castgate package as docs/TUTORIAL.md.