Skip to content

v3.1.0 — docker images, metadata, and privacy

Latest

Choose a tag to compare

@heysonder heysonder released this 12 Sep 00:45
f361ade

what's new

v3.1.0 brings prebuilt docker images, better metadata, private feedback updates, and the fixes shipped since v3.0.0. this collects the improvements from april through september that had not yet been included in a release summary.

  • prebuilt docker images — public images for linux amd64 and arm64, exact version tags, and a latest tag for stable releases. prereleases only update their own version tag.
  • simpler self-hosting — a release compose file runs the published image without building locally. provider credentials remain optional runtime settings.
  • better metadata — the spotify unfurl pipeline, shared download preparation, improved caching and image fallbacks, and corrected artist, album artist, and compilation tags across tracks, playlists, and browser conversion.
  • private feedback updates — follow reports from the browser where you submitted them, optionally include browser details, and avoid repeated status refreshes.
  • mobile verification fixes — browser-based proof-of-work with fresh tokens for each request, retries for expired verification, and more tolerance for clock drift and background tabs.
  • download and interface fixes — more time for slower browser conversion before server fallback, clearer download errors and report links, and inputs that avoid unwanted zoom on ios safari.
  • privacy and diagnostics — clearer explanations of data handling, feedback, and browser storage. structured diagnostic logs omit user content and direct identifiers, with automatic seven-day retention in the production launcher.
  • source reliability and maintenance — playlist throttling, expanded source-health reporting, security fixes, updated dependencies including yt-dlp 2026.08.19, and refreshed pnpm-based development and docker builds.
  • source access — repository links now point to the yoinkify organization, with a dedicated source-code link in the app.

run the image

docker pull ghcr.io/yoinkify/yoink:v3.1.0

for docker compose:

git clone --branch v3.1.0 --depth 1 https://github.com/yoinkify/yoink.git
cd yoink
cp .env.example .env
docker compose -f docker-compose.release.yml up -d --pull always

set YOINK_VERSION=v3.1.0 in .env to stay on this release. leave it unset to follow latest. add optional provider credentials to .env at runtime.

verification

both published architectures passed native container startup checks, including the health endpoint, ffmpeg, and yt-dlp. anonymous registry access was verified, and the arm64 release image completed a real mp3 download with metadata and cover art without provider credentials.

all changes since v3.0.0