# Sonicverse Docs

> Open-source software for independent media

## Docs

- [PostHog analytics and Pushover alert setup](https://docs.sonicverse.eu/audiostreaming-stack/analytics.md): Configure PostHog event tracking for listener metrics and enable Pushover push notifications for silence detection, stream failures, and mount changes.
- [Audio pipeline architecture and signal flow](https://docs.sonicverse.eu/audiostreaming-stack/architecture.md): Understand how audio flows from your studio encoder through Liquidsoap, Icecast2, and Nginx, including the HLS adaptive bitrate pipeline and fallback chain.
- [Audio streaming stack changelog and releases](https://docs.sonicverse.eu/audiostreaming-stack/changelog.md): Version history for the audio streaming stack covering new features, security patches, bug fixes, breaking changes, and step-by-step upgrade instructions.
- [Community code of conduct for contributors](https://docs.sonicverse.eu/audiostreaming-stack/code-of-conduct.md): Community guidelines covering expected behavior, enforcement policies, and reporting procedures for respectful participation in Sonicverse open-source projects.
- [Environment variable configuration reference](https://docs.sonicverse.eu/audiostreaming-stack/configuration.md): Complete reference for every .env variable in the audio streaming stack, including station metadata, Icecast passwords, SSL certificates, and analytics.
- [Contributing to the audio streaming stack](https://docs.sonicverse.eu/audiostreaming-stack/contributing.md): Fork the repository, set up a local development environment, submit pull requests, and follow the coding standards for contributing to the streaming stack.
- [Firewall and port configuration for streaming](https://docs.sonicverse.eu/audiostreaming-stack/firewall.md): Open the required ports for HTTP, HTTPS, and studio encoder inputs, then run the automated UFW firewall script to lock down your streaming server.
- [Audio streaming stack overview and features](https://docs.sonicverse.eu/audiostreaming-stack/index.md): Self-hosted Docker Compose stack for live radio broadcasting with Icecast2, HLS adaptive bitrate, automatic fallback, silence detection, and real-time alerts.
- [Quickstart: install the audio streaming stack](https://docs.sonicverse.eu/audiostreaming-stack/quickstart.md): Set up the audio streaming stack on a Linux server in under five minutes using the interactive installer or Docker Compose with step-by-step instructions.
- [Security policy and vulnerability reporting](https://docs.sonicverse.eu/audiostreaming-stack/security.md): Report vulnerabilities through GitHub private disclosure, review supported versions, and understand the coordinated security response process for the stack.
- [Published security advisories and CVEs](https://docs.sonicverse.eu/audiostreaming-stack/security-advisories.md): Review published security advisories for the audio streaming stack with severity ratings, affected versions, CVSS scores, remediation steps, and workarounds.
- [Real-time operator status panel and dashboard](https://docs.sonicverse.eu/audiostreaming-stack/status-panel.md): Monitor live listener counts, Docker container health, and recent alerts using the real-time operator dashboard built with Flask and deployed on Next.js.
- [Stream endpoints and listener URLs](https://docs.sonicverse.eu/audiostreaming-stack/streams.md): Reference for all listener-facing endpoints including Icecast mount paths, HLS adaptive bitrate playlists, and studio encoder input ports with formats.
- [Contact support and community channels](https://docs.sonicverse.eu/audiostreaming-stack/support/contact.md): Get help with the audio streaming stack through the Sonicverse Slack community, support email, GitHub issues, and open-source community discussions.
- [Audio streaming FAQ: requirements, Pi support, updates](https://docs.sonicverse.eu/audiostreaming-stack/support/faq.md): Answers to common questions about system requirements, supported audio formats, ARM and Raspberry Pi compatibility, and customizing the streaming stack.
- [Quick fixes for common Docker and audio errors](https://docs.sonicverse.eu/audiostreaming-stack/support/troubleshooting.md): Step-by-step solutions for containers not starting, missing audio output, status panel errors, high resource usage, and Docker Compose configuration failures.
- [Troubleshooting common streaming issues](https://docs.sonicverse.eu/audiostreaming-stack/troubleshooting.md): Diagnose and fix common audio streaming problems including silent streams, SSL certificate errors, encoder connection failures, and container restart loops.
- [Security hub for Sonicverse open-source projects](https://docs.sonicverse.eu/security.md): Central security hub for all Sonicverse projects — vulnerability reporting, security practices, hardening guides, advisories, and tooling.
- [Sonicverse website changelog and release notes](https://docs.sonicverse.eu/website/changelog.md): Version history for the Sonicverse website covering new features, design updates, improvements, and bug fixes across landing pages, blog, and contact forms.

## Optional

- [GitHub](https://github.com/sonicverse-eu)