FlowCastRadio Automation
Preview UIGitHub

INSTALLATION · 0.1.0-rc.8

Install FlowCast Community

The current validated installer targets an operator-managed Linux amd64 host. Review the installer and security model before running it.

Prerequisites

  • Linux amd64, Docker Engine and Docker Compose v2
  • 2 CPU cores, at least 4 GB RAM and 10 GB free disk plus media storage
  • Free TCP ports 8080 for the control/player proxy and 8010 for direct Icecast access
  • The standard command-line tools required by the installer, including curl, openssl, tar and sha256sum

Run the validated tagged installer

Current validated Community release: 0.1.0-rc.8. 

curl -fsSL https://raw.githubusercontent.com/chourmovs/FlowCast-Community/v0.1.0-rc.8/install.sh | sudo bash -s -- --version 0.1.0-rc.8

The installer does not install Docker. It verifies the release archive, writes /opt/flowcast, generates a mode-0600 .env, pulls immutable versioned service images and waits for service health.

An existing installation environment is not silently overwritten. Back up before updating or replacing an installation.

Review the installer first

For a more conservative installation process, download and inspect the tagged script before running it: 

curl -fsSLO https://raw.githubusercontent.com/chourmovs/FlowCast-Community/v0.1.0-rc.8/install.sh
less install.sh
sudo bash install.sh --version 0.1.0-rc.8

Open the interface and broadcast

  1. Open http://localhost:8080, or the LAN address displayed by the installer.
  2. Sign in with the locally generated credentials.
  3. Import audio that you own or are permitted to store and broadcast.
  4. Create or select a playlist and configure its programming.
  5. Start playout when Docker Control is enabled.
  6. Listen through /listen/test.mp3 on the control origin, or directly through http://HOST:8010/test.mp3.
  7. Run the diagnostic command and confirm that it ends with RESULT=PASS. 
sudo /opt/flowcast/scripts/community/doctor.sh

Follow the complete first-broadcast guide .

Diagnose, update and roll back

sudo /opt/flowcast/scripts/community/doctor.sh
sudo /opt/flowcast/scripts/community/backup.sh
sudo /opt/flowcast/scripts/community/update.sh --version 0.1.0-rc.8

Back up before every version change. The update tooling preserves the installation’s credentials, persistent volumes and explicit Docker Control choice, subject to the release-specific compatibility notes.

Use the documented backup and restore path for deliberate recovery or rollback. Preview releases do not guarantee downgrade-compatible persisted state.