boazsender/portal
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
portal/docs/how-to-turn-it-on.md
Boaz Sender 1b5892fd5f add cloudflare tunneling to broadcaster
2025-06-29 12:49:02 -04:00

2.4 KiB
Raw Blame History

Hardware setup instructions

This readme contains instructions for plugging in the system and turning it on. Full software setup documentation is in the broadcaster-software.md and listener-software.md files.

Make sure to do the following steps in the order they are listed:

Requirements

  • Modem and internet plan (no static IP required - uses Cloudflare Tunnel)
  • Provisioned broadcaster with Cloudflare Tunnel configured
  • Provisioned listener
  • Domain transferred to Cloudflare (blackportaldetroit.com)

Steps

Turn on broadcaster

  1. Plug the usb mic cable into a microphone
  2. Plug the usb mic cable into the top right (blue colored) usb port on the broadcaster (raspberry pi 4b)
  3. Plug the ethernet cable into the broadcaster and the router
  4. Plug the power into the broadcaster (this is how you turn it on)

Networking

  1. Either configure cloudlfare tunnel, ddns or setup a static ip and forward from your router

Turn on listener

  1. Turn on the listener (raspberry pi zero). plug it into a monitor and keyboard. when it boots, type sudo raspi-config. navigate to system settings and change the wifi settings so it can access the internet.
  2. The listener is pre-configured to stream from http://blackportaldetroit.com/portal.m3u - no manual configuration needed.
  3. Type sudo systemctl restart listener
  4. mic check

Important notes

  • The microphone must always be plugged into the broadcaster before the broadcaster is on
  • The broadcaster must always be on when the listener is turned on. if it is not, then the listener needs to be restarted once the broadcaster is on.
  • SSL certificates are handled automatically by Cloudflare
  • Stream will be accessible at https://blackportaldetroit.com/portal
  • No router configuration or port forwarding needed

Troubleshooting Cloudflare Tunnel

Setup Steps:

  1. Transfer blackportaldetroit.com to Cloudflare (change nameservers)
  2. Run ./cloudflare-tunnel-setup.sh on the Pi
  3. Follow the authentication prompts
  4. Create CNAME record in Cloudflare dashboard

Common Issues:

  • Domain not on Cloudflare: Transfer nameservers first
  • Authentication failed: Run cloudflared tunnel login manually
  • Tunnel not connecting: Check sudo systemctl status cloudflared

Test Commands:

# Check tunnel status
sudo systemctl status cloudflared

# View tunnel logs
sudo journalctl -u cloudflared -f

# Test local connectivity
curl -I http://localhost:80