Backups & migrations

Playify is completely portable. It doesn’t rely on complex external databases like PostgreSQL or Redis. Everything is stored locally.

If you are moving Playify to a new computer, a VPS, or a Docker container, you only need to copy two specific files to retain all your configurations, queues, and server states.

Important files to backup

1. data/playify_state.db This is a robust SQLite database. It contains:

   • The persistent controller channel and message IDs for every server.
   • The current song queues and histories for all active players.
   • Specific server settings (like allowlist channels or kawaii mode).
   • If you lose this file, you will need to re-run /setup controller in all your servers.

2. data/settings.json This JSON file stores your TUI dashboard settings, such as:

   • Your preferred Discord presence (e.g., “Playing /help”).
   • The default volume.
   • UI theme configurations.

3. .env (optional but recommended) Contains your Discord, Spotify, and Genius tokens. If you don’t copy this, you will simply have to re-enter them in the setup wizard on your new machine.

How to migrate

1. Stop the bot gracefully on your old server (press Q in the TUI to ensure the SQLite database is closed cleanly and not corrupted).
2. Zip or copy the data/ folder and your .env file.
3. Install Playify on your new server following the installation guide.
4. Before running the start.bat or start.sh script, paste the data/ folder and .env file into the new Playify root directory.
5. Start the bot. It will instantly resume its previous state!