Skip to content

v1.0.0

Choose a tag to compare

@RyDizz214 RyDizz214 released this 10 Jun 07:02
· 60 commits to main since this release
v1.0.0
23e87ac

Release v1.0.0 — Snappier-Server Docker

Date: 2025-06-09

Overview

This is the first production release of Snappier-Server Docker, a containerized distribution of the [Snappier-Server] binary. This image packages the official Snappier-Server app (maintained by Sarah Bainbridge) atop Ubuntu 25.04 with FFmpeg, along with a custom notification system for real‑time push alerts.

Disclaimer: The Snappier-Server binary is © Sarah Bainbridge and her team. This repository and Docker image are maintained by RyDizz214, who provides the container and custom notification modules only.


Key Features

  • Official Snappier-Server Binary v1.0.0

  • Ubuntu 25.04 base image including:

    • ffmpeg for recording, streaming, and remuxing
    • bash, curl, jq, and other runtime dependencies
  • Integrated Push Notifications:

    • Recording Events: start and completion alerts
    • Download Events: movie, series, and catch-up begin/end
    • Error Notifications: any server errors or failures
  • Multi-Stage Build:

    • snappier-server stage fetches and installs the binary
    • notifier stage bundles a Node.js push service (Pushover, ntfy.sh, Telegram, Discord)
    • final stage assembles the runtime image with entrypoint scripts
  • Health Check Endpoint at /serverStats for liveness/readiness probes

  • Environment‑Based Configuration via a .env file (see example.env)

  • Docker Compose example for one‑command deployment


Installation & Usage

  1. Clone the repo

    git clone https://github.com/rydizz214/snappier-server-docker.git
    cd snappier-server-docker
  2. Create your config

    cp example.env .env
    # Edit .env: set SNAPPIER_SERVER_VERSION, ports, and your notification keys
  3. Build & push image (if modifying locally)

    docker compose build
    docker compose up -d
  4. Pull & run (production)

    docker pull ghcr.io/rydizz214/snappier-server-docker:v1.0.0
    docker compose up -d

Notification System

The container includes a Node.js–based push notification service:

  • Pushover: set PUSHOVER_USER_KEY & PUSHOVER_API_TOKEN
  • ntfy.sh: set NTFY_TOPIC
  • Telegram: set TELEGRAM_TOKEN & TELEGRAM_CHAT_ID
  • Discord: set DISCORD_WEBHOOK_URL
  • Gotify: set GOTIFY_SERVER & GOTIFY_TOKEN

You will receive real‑time alerts when:

  • A recording starts or finishes
  • A movie/series/catch‑up download begins or completes
  • Any server error occurs

Contributing & Support

  • Docker & Notifier Issues: Please file bugs, feature requests, or pull requests against this repository.
  • Snappier-Server App Issues: Reach out to Sarah Bainbridge and the official Snappier-Server team via [snappierserver.app]] or on SnappierIPTV’s Discord.

Join the community: [SnappierIPTV Discord]]


Thank you for using Snappier-Server Docker!