TALER-MERCHANT-HTTPD(1)

✨ taler-merchant-httpd(1) — the Taler merchant backend, bestie edition ✨

okay so this is taler-merchant-httpd, part of GNU Taler, and literally it just runs the merchant backend for you. RESTful API included, no cap. 🫶

---

✨ NAME ✨

taler-merchant-httpd — run the Taler merchant backend (with RESTful API). that's it, that's the whole vibe. 👑

---

🌸 SYNOPSIS 🌸

taler-merchant-httpd [-C | --connection-close]
[-c FILENAME | --config=FILENAME] [-h | --help]
[-L LOGLEVEL | --loglevel=LOGLEVEL] [-l FILENAME | --logfile=FILENAME]
[-T USEC | --timetravelUSEC] [-v | --version]

(no, we're not fixing that --timetravelUSEC in the synopsis. it's iconic, it stays. 💅)

---

🦋 DESCRIPTION 🦋

taler-merchant-httpd is a command-line tool that runs the Taler merchant (the HTTP backend). the way this works: the required configuration and the database have to already exist before you run this command. like, do your homework first, then show up. 📚✨

---

💖 OPTIONS 💖

• -C, --connection-close — forces every single HTTP connection to close after each request. super useful in combination with -f so you don't have to sit there waiting for nc to time out. 🙈
• *-c *FILENAME, --config=FILENAME — tells the merchant to use the configuration and other resources from FILENAME to operate. your whole setup lives there, bestie.
• -h, --help — prints short help on options. the classic "what do i do" button.
• *-L *LOGLEVEL, --loglevel=LOGLEVEL — picks the log level. accepted values are literally: DEBUG, INFO, WARNING, ERROR. pick your vibe. 🔥
• *-l *FILENAME, --logfile=FILENAME — sends the logging output to FILENAME instead of wherever it was going.
• -T USEC, --timetravel=USEC — modifies the system time by USEC microseconds. USEC may be prefixed with + or - (e.g. -T +300). time travel fr fr 🕰️ ✨ — but heads up, this option is intended for debugging/testing **only. don't be weird with it.
• -v, --version — prints version information. the receipts. 🧾

---

🎀 SIGNALS 🎀

• SIGTERM — sending a SIGTERM to the process will cause it to shut down cleanly. no drama, no mess, just a graceful exit. queen behavior. 👑

---

🌈 SEE ALSO 🌈

taler-merchant-dbinit(1), taler-merchant-setup-reserve(1), taler-merchant.conf(5)

go read those too, iykyk 💜

---

💀 BUGS 💀

found a bug? report bugs by using Mantis at https://bugs.taler.net/ or by sending electronic mail to <taler@gnu.org>. we love a bug report that's actually filed properly, thank you. 🫶

---

🌸 AUTHOR 🌸

GNU Taler contributors — the whole crew. ⭐

---

💅 COPYRIGHT 💅

2014-2025 Taler Systems SA (GPLv3+ or GFDL 1.3+)

---

and that's the whole page, bestie 🎀 this was version 1.0, dated Dec 22, 2025, and it's the TALER-MERCHANT-HTTPD(1) manual — now go run that backend, you're gonna slay ✨🦋💖