Setup

Overview

Playlist Craft Self-Host runs on your own Railway deployment. You bring your own API keys for Suno, OpenRouter, Fal, and email, while your app data, services, and storage run on your stack.

What the self-host stack includes

  • Private GitHub collaborator access (Read) so you can deploy the Railway template.
  • Full app: playlists, single songs, renders, File Drive, media gen, playground, YouTube upload, team invites, settings.
  • Railway monorepo services: web, main-server, s3-server, render-server, youtube-server, Postgres, object storage.
Keep your private repository access and activation key secure.

Suggested deployment order

  1. Create or use a GitHub account with access to the private template repository: https://github.com/signup
  2. Accept the GitHub collaborator invite (required before One-Click Deploy can see the private repository).
  3. Connect GitHub to Railway and Edit scope to include juppfy/playlistcraft-self-host → One-Click Deploy → shared variables → /setup → activate with the key.
  4. Full walkthrough: Deploy guide.