Core Cast Server Setup

This repository contains an automated setup script to configure a Debian-based Linux host (like Ubuntu or Raspberry Pi OS) to securely run a self-hosted Core Cast server.

What It Does

The setup.sh script is fully interactive and automates the following:

1. Dependency Checks: Installs nginx, certbot, docker, docker-compose, and curl if they are missing.
2. DuckDNS Setup: Configures a cron job to automatically update your DuckDNS domain with your host's dynamic IP.
3. Docker Security: Modifies your existing docker-compose.yml to bind the Core Cast ports (50350, 50351, 8001, 8002) to 127.0.0.1 (localhost), making them inaccessible from the public internet.
4. Nginx Configuration: Sets up Nginx as a reverse proxy using the provided template.
5. SSL Setup: Uses Certbot (Let's Encrypt) to automatically obtain a free SSL certificate for your domain.

This process solves the "Mixed Content" browser error by serving your WebSocket (wss://) and API (https://) connections securely from the same domain.

Prerequisites

1. A Debian-based Linux host (Ubuntu, Debian, Raspberry Pi OS, etc.).
2. A running Core Cast sdr-control container managed by a docker-compose.yml file somewhere on the host.
3. A DuckDNS account with a domain and token.
4. Your router/firewall must be configured to forward ports 80 and 443 to this host machine.

How to Use

1. Clone this repository onto your host machine:

   git clone [https://github.com/corecastsdr/corecast-server-setup.git](https://github.com/your-username/corecast-server-setup.git)
   cd corecast-server-setup

2. Make the setup script executable:

   chmod +x setup.sh

3. Run the script with sudo:

   sudo ./setup.sh

4. Follow the interactive prompts. You will need to provide:

   • Your DuckDNS domain (e.g., my-sdr.duckdns.org)
   • Your DuckDNS token
   • Your email address (for SSL certificate registration)
   • The full path to your sdr-control docker-compose.yml file.

The script will handle the rest. Once it's finished, your server is ready.

Final Step

In your Core Cast website UI, when you register your "self-hosted" station, use your DuckDNS domain (e.g., my-sdr.duckdns.org) in the "Server IP" field. The sdr.tsx file is already coded to build the correct wss://.../audio paths from this domain.