prosody-migrator(8)

📦
version 13.0.6 · 6 versions
, in ubuntu stonking

✨ prosody-migrator — the manual page, bestie edition ✨

okay so you're reading the prosody-migrator(8) man page and honestly? good for you. this is the cute lil tool that moves your data around. let's get into it 💖

🌸 NAME 🌸

prosody-migrator</purage> — migrate data between Prosody data stores. that's it, that's the whole vibe. it moves stuff from one place to another 🦋

🎀 SYNOPSIS 🎀

prosody-migrator [OPTIONS] [SOURCE_STORE DESTINATION_STORE]

look at that. so clean. so iconic. the square brackets mean "these are optional, bestie, but like… you probably want them" 💅

✨ DESCRIPTION ✨

prosody-migrator is literally the move-your-stuff tool. it's used to move data (user accounts, rosters, vcards, etc.) between different data stores. so like, if you've been living that file-based-store life and you wanna glow up into an SQL database? this is your moment. and yes, it works the other direction too — SQL back to files. both ways. we love a versatile queen 👑

⚠️ okay heads up, this part is IMPORTANT and i need you to actually read it: the migrator assumes that the destination store is empty. existing data that conflicts with data in the source store will be overwritten! like, gone. not coming back. main character exit. so pls pls pls check your destination first, okay? 🫶

💅 OPTIONS 💅

  • --config=FILENAME — tell it to use a different config file instead of the usual one. the default is /etc/prosody/migrator.cfg.lua, which is where the vibes live by default 🍓
  • SOURCE_STORE — the name of the store you're pulling data from. this name has to be defined in the config file (iykyk). defaults to 'input' if you don't say anything 🌈
  • DESTINATION_STORE — the name of the store you're pushing data to. also defined in the config file, same deal. defaults to 'output' if you stay silent 🎀

🌼 FILES 🌼

  • /etc/prosody/migrator.cfg.lua — the migrator config file. this is where your stores get their names and their whole personality 💜

🔥 SEE ALSO 🔥

go read those too, they're part of the family 🫶

👑 AUTHOR 👑

Matthew Wild <mwild1@gmail.com> — the actual genius behind this. say thank you ✨

and that's the whole page, bestie!! written by Prosody IM, dated 23 July 2026, filed under prosody-migrator(8). now go migrate responsibly and don't overwrite anything you love 💖💅🦋

📦 where this page comes from