XAPIAN-REPLICATE(1)

📦
version 2.0.0 · 9 versions
, in alpine 3.24

✨ XAPIAN-REPLICATE(1) ✨

okay so real talk, this is a page from User Commands, and it's about xapian-replicate — the literal main character of "copy my database from the master server to my local little home." bestie, let's get into it 💅

🌸 NAME 🌸

xapian-replicate — replicate a database from a master server to a local copy. that's it, that's the vibe. no cap. 🦋

🎀 SYNOPSIS 🎀

xapian-replicate [OPTIONS] DATABASE

💖 DESCRIPTION 💖

xapian-replicate — replicate a database from a master server to a local copy.

yes it says the same thing twice, she's consistent, she's iconic, she knows what she is 👑 literally the whole job is: master server has the database, your local copy wants the database, this tool makes it happen. periodt.

✨ OPTIONS ✨

okay so here's the whole menu, no skips, no "you don't need to know that one," we're covering everything fr fr 🫶

  • -h, --host=HOST — the host to connect to. this one is required, like genuinely mandatory, not the cute optional kind of required 🙈
  • -p, --port=PORT — the port to connect to. also required! both of these, non-negotiable 💀
  • -m, --master=DB — replicate database DB from the master (default: DATABASE). so if you don't say, it just assumes you mean the DATABASE you already gave it, lowkey smart
  • -i, --interval=N — wait N seconds between each connection to the master (default: 60). she's patient, she's pacing herself, we respect the boundaries ⭐
  • -r, --reader-time=N — wait N seconds to allow readers time to close before applying repeated changesets (default: 30). giving the readers a lil grace period before the changesets drop, so polite 🧚
  • -t, --timeout=N — set socket timeouts (if supported) to N seconds; N=0 for no timeout (default: 0). note the "if supported," bestie — that's a real caveat, not decoration. and 0 literally means no timeout at all, so know that going in 👀
  • -f, --force-copy — force a full copy of the database to be sent (and then replicate as normal). sometimes you just gotta start fresh, full send 🔥
  • -o, --one-shot — replicate only once and then exit. one and done, no lingering, no loop, we love a clean exit 💜
  • -q, --quiet — only report errors. silent mode, mysterious mode, doesn't-text-back mode 😭
  • -v, --verbose — be more verbose. she's telling you EVERYTHING and honestly? obsessed 🌈
  • --help — display this help and exit. classic, reliable, always there for you 🎀
  • --version — output version information and exit. show me the numbers bestie 💅
quick vibe check: --host and --port are the two that have "(required)" slapped on them, so don't come to the function without them, ok? 🙈

and that's the whole page, no crumbs left behind 🌸

sign-off time — this iconic lil page came from xapian-core 2.0.0, dated March 2026. slay, mwah, see you in the group chat 💖🦋✨

📦 where this page comes from