BARMAN-RECEIVE-WAL(1)

✨ BARMAN-RECEIVE-WAL ✨

okay bestie, welcome to the barman-receive-wal page 💖 this is one of the Barman Sub-Commands, and it's literally the one that keeps your transaction logs flowing. let's get into it 🫶

---

🌸 SYNOPSIS 🌸

receive-wal
    [ --create-slot ]
    [ --if-not-exists ]
    [ --drop-slot ]
    [ { -h | --help } ]
    [ --reset ]
    [ --stop ]
    SERVER_NAME

---

💅 DESCRIPTION 💅

so what this does is it kicks off the streaming of transaction logs for a server. it uses pg_receivewal or pg_receivexlog to grab WAL files from your Postgres servers over the streaming protocol. that's the whole vibe. no cap 🔥

---

🎀 PARAMETERS 🎀

• SERVER_NAME — the name of the server in barman node. that's who we're talking to, periodt.
• --create-slot — makes the physical replication slot that's configured with the slot_name configuration parameter. new slot, who dis ✨
• --if-not-exists — so when you pass --create-slot and a slot with that specified name is already there, this stops it from erroring out. it's giving chill energy. lowkey essential 🙈
• --drop-slot — drops the physical replication slot that's configured with the slot_name configuration parameter. bye bestie 👋
• -h / --help — shows a help message and exits. it gives you the info about command usage. iconic behavior 💜
• --reset — resets the status of receive-wal, which restarts the streaming from the current WAL file of the server. fresh start, main character energy 🌈
• --stop — stops the process for the server. 🛑

⚠️ Warning: the --stop option for the barman receive-wal command is gonna be obsoleted in a future release. like fr fr, it's on the way out. users should favor using the terminate-process <#commands-barman-terminate-process> command instead, because that's the new way of handling this feature. so maybe start switching over now, bestie 💀

---

👑 Author 👑

EnterpriseDB

---

🦋 Copyright 🦋

© Copyright EnterpriseDB UK Limited 2011-2026

---

and that's the whole page, babes 🍓 this was Barman version 3.20, dated Sep 29, 2026, and the manual name is BARMAN-RECEIVE-WAL(1). slay, go stream those WAL files 💖✨