πŸ“‘
Station Operator Guide

WavuWebTv

From installation to your first programming schedule. Follow the sections in order when setting up a new station.

πŸ‘€
Start here

Follow the sections in order when setting up a new station.

🧰
BEFORE YOU BEGIN

Install Docker

WavuWebTv runs inside Docker. You must have Docker installed and running on the machine that will host your station before running the installer.

⚠️
The installer will fail without Docker.

If Docker is not installed, the installer stops with Docker is not installed and does not proceed. Install Docker first, then continue.

Windows

Install Docker Desktop. Download: docs.docker.com/desktop/setup/install/windows-install

macOS

Install Docker Desktop for Mac. Download: docs.docker.com/desktop/setup/install/mac-install

Linux

Install Docker Engine (not Docker Desktop). Install instructions: docs.docker.com/engine/install

Choose the instructions for your distribution (Ubuntu, Debian, Fedora, etc.). After installation:

πŸ’‘
Running a business? Docker Desktop on Windows and macOS is free for personal use, education, and small businesses under 250 employees and under $10M annual revenue. Above those thresholds it requires a paid subscription. If you are an established business, or if you want to avoid the license entirely, run your station on a Linux VPS instead β€” Docker Engine on Linux is free and unrestricted.

Confirm Docker works

Open a terminal (PowerShell on Windows, Terminal on macOS, or your shell on Linux) and run:

docker version

You should see output with both a Client section and a Server section. If the Server section says "Cannot connect to the Docker daemon," Docker Desktop is not running β€” start it and wait for it to finish loading, then try again.

Also run:

docker compose version

You should see a version number starting with v2. If it says "docker: 'compose' is not a docker command," you have an older Docker installation β€” update to the current Docker Desktop or Docker Engine release.

Keep Docker running

Your station runs inside Docker. If Docker stops, your station stops. Two things to configure once after installation:

Windows and macOS β€” Docker Desktop auto-start

Open Docker Desktop β†’ Settings β†’ General β†’ enable Start Docker Desktop when you sign in to your computer.

On Windows, Docker Desktop only starts after a user logs in. For a station that must be available 24/7, either leave the operator session logged in, or configure Windows to auto-login that user. Otherwise your station will be offline after any reboot until someone logs in.

Linux β€” Docker service

Confirm Docker starts on boot: sudo systemctl is-enabled docker should print enabled. If it prints disabled, run sudo systemctl enable docker.

Resource limits (Docker Desktop only)

Docker Desktop defaults to 2 GB of memory and 2 CPU cores. That is not enough for a station that runs live broadcasting, video transcoding, and the admin console simultaneously.

Open Docker Desktop β†’ Settings β†’ Resources and set:

Click Apply & Restart.

Linux does not have these per-VM limits β€” Docker Engine uses the host's full resources directly. The 4 GB / 2 CPU minimum applies to the host machine either way.

πŸ“¦
PART 1

Install WavuWebTv

Your WavuWebTv installation begins with the package and passkey provided with your purchase.

1. Download the installation package

You will receive:

The package will look similar to:

wavuweb-dist-0.1.5.tar.gz

Your browser will normally save it to your Downloads folder.

πŸ’‘
Important: Do not create the WavuWebTv installation directory yourself. The installer creates the permanent directory for you.

2. Extract the package

Windows

Open Downloads, right-click the .tar.gz file and select Extract All….

This creates a folder similar to:

Downloads\
    wavuweb-dist-0.1.5\

Linux / macOS

cd ~/Downloads
tar -xzf wavuweb-dist-0.1.5.tar.gz
cd wavuweb-dist-0.1.5

3. Start the installer

Windows

.\install.ps1

Linux / macOS

bash install.sh

4. Choose the installation directory

The installer asks:

Install WavuWebTv to which directory? [C:\WavuWebTv]

Press Enter for the default location, or type another location such as:

D:\WavuWebTv
πŸ“
You do not need to create the directory. The installer creates it and moves the WavuWebTv installation there.

5. Complete the installation prompts

The installer will request:

Once the required information is entered, the installer prepares the station, obtains the required application images, configures the station, and starts the WavuWebTv services.

⚠️
Live broadcasting note

Internet live broadcasting has additional network requirements. The public station URL alone does not guarantee that WebRTC live broadcasting will work.

πŸ”
PART 2

Open Your Station & Log In

1. Open your station

Open the public station URL you entered during installation.

https://yourstation.example.com

You should see your station's public landing page.

2. Click Login

Administrator access begins from the station page. Click the Login button.

3. Select Verified User

Select Verified User from the available login options.

4. Select Admin Login

At the bottom of the Verified User area, click Admin Login.

Enter the administrator password you created during installation. After successful authentication, you will enter the WavuWebTv administration area.

πŸ”
Keep your administrator password secure.

It controls access to your station's administrative functions.

🎨
PART 3

Set Up Your Station Identity

After logging in, establish how your station identifies itself to viewers. Open Admin β†’ Identity.

🏷️ Station Name

Enter the name you want viewers to see as the name of your station, then click Save.

πŸ“ Channel Description

Add a short description explaining what your station is about, then click Save.

The channel description is displayed on the public landing page.

πŸ–ΌοΈ Station Logo

Under Logo, click Upload and select your station logo.

Supported formats:

🌐 Favicon

Under Favicon, click Upload and select your favicon. A favicon of 32Γ—32 pixels or larger is supported.

🎬 Transition Video

You can optionally upload a short transition video to play between programs on the public landing page.

If no transition video is provided, programs advance directly without an interstitial.

πŸ“œ
PART 4

Set Your Terms & Policies

Open Admin β†’ Terms & Policies.

Review the available policy settings and enter the information appropriate for your station.

Your policies should clearly address the rules that apply to your station, including as appropriate:

πŸ“œ
Your station is your operation. Make sure the policies you publish accurately represent how you intend to operate it.
πŸ—„οΈ
PART 5

Upload Content to Storage

πŸ’‘
Storage is already configured.

You do not configure storage during this step. Installation has already established the station's storage.

Storage is your station's content library. This is where you upload and keep the content belonging to your station.

Content uploaded to Storage is not automatically placed into the station's programming schedule.

πŸ“€ Upload your content

Open Admin β†’ Storage and upload the media you want your station to use.

This might include:

πŸ“š Understanding unscheduled content

Uploaded content can remain in Storage without being scheduled. This lets you build your content library first and decide later when individual items should become part of your station's programming.

πŸ“€ Upload
β†’
πŸ—„οΈ Storage
β†’
πŸ—“οΈ Schedule
β†’
πŸ“Ί Programming
πŸ—“οΈ
PART 6

Schedule Your Content

Once you have content in Storage, you can decide what becomes part of your station's programming.

Open Admin β†’ Schedule.

πŸ—“οΈ Storage vs. Schedule

πŸ—„οΈ

Storage

Your available content library. Content can remain here without being part of the station's current programming.

πŸ—“οΈ

Schedule

Content you have placed into programming. This is where you manage scheduled content and its availability.

🧠
Easy way to remember it: Storage holds what you have. Schedule manages what you are programming.

πŸ“Ί Manage scheduled content

Use the Schedule area to review your programming, add content to the schedule, and manage the availability of scheduled content.

πŸŽ›οΈ
PART 7

Choose How Your Station Operates

Open Admin β†’ Operator.

The Operator page controls the station's scheduling mode. You can choose:

πŸ€–

Automatic

The station handles scheduling automatically according to the programming available to it.

βš–οΈ

Hybrid

Automatic scheduling and operator control work together, allowing routine automation while retaining operator intervention.

🎚️

Manual

The operator has direct control over station programming.

πŸ€– Automatic

Use Automatic when you want the station to continue operating without manually controlling every programming decision.

βš–οΈ Hybrid

Use Hybrid when you want the station to handle routine scheduling automatically while retaining the ability to intervene.

🎚️ Manual

Use Manual when you want direct control over what happens with your station's programming.

πŸ”„
HOW IT FITS TOGETHER

The Station Workflow

🎨IdentityWho are you?
↓
πŸ“œPoliciesWhat are your rules?
↓
πŸ—„οΈStorageWhat do you have?
↓
πŸ—“οΈScheduleWhat are you programming?
↓
πŸŽ›οΈOperatorHow should it run?
πŸ“Œ
Three areas to remember

Storage is your content library. Schedule is your programming. Operator controls how scheduling runs.

πŸ“‘
PART 8

Live Broadcasting

Live broadcasting has additional network requirements beyond the normal station website.

WavuWebTv uses WebRTC for live broadcasting. Internet viewers may require a reachable public IP, appropriate UDP access, and TURN relay support depending on their network.

⚠️
Advanced network configuration

Review the separate Live Broadcasting IP and TURN Setup guide before operating live broadcasts for public internet viewers.

That guide covers:

βœ…
FINAL CHECK

Station Setup Checklist

Check each item as you complete your station setup.

πŸ“¦ Installation

πŸ” Administrator Access

🎨 Station Identity

πŸ“œ Terms & Policies

πŸ—„οΈ Content

πŸŽ›οΈ Station Operation

Setup progress 0%
πŸš€

Your Station Starts Here

You do not need a complete library before you begin. Establish your identity. Add your policies. Upload content. Build a schedule. Choose how you want the station to operate. Then keep building.

🎨 Identity β†’ πŸ—„οΈ Content β†’ πŸ—“οΈ Programming β†’ πŸ“Ί Station