taler-merchant-httpd(1)

24.107. taler-merchant-httpd(1)#

24.107.1. Name#

taler-merchant-httpd - Run Taler merchant backend (with RESTful API)

24.107.2. Synopsis#

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

24.107.3. Description#

taler-merchant-httpd is a command-line tool to run the Taler merchant (HTTP backend). The required configuration and database must exist before running this command.

24.107.4. Options#

-3 | –http3

Enable the use of HTTP/2 and HTTP/3. Without this option, we force libcurl to only use HTTP/1.1 when talking to the exchange or to the Donau. Note that for some libcurl builds, we will still use HTTP/1.1 even with this option if HTTP/2 or HTTP/3 support are not deemed to be stable enough. Setting this option may provide a minor performance benefit, but it may cause stability issues depending on the libcurl version used, hence it is off by default.

-C | –connection-close

Force each HTTP connection to be closed after each request (useful in combination with -f to avoid having to wait for nc to time out).

-c FILENAME | –config=FILENAME

Use the configuration and other resources for the merchant to operate from FILENAME.

-h | –help

Print short help on options.

-L LOGLEVEL | –loglevel=‌LOGLEVEL

Specifies the log level to use. Accepted values are: DEBUG, INFO, WARNING, ERROR.

-l FILENAME | –logfile=‌FILENAME

Send logging output to FILENAME.

-T USEC | –timetravel=USEC

Modify the system time by USEC microseconds. USEC may be prefixed with + or - (e.g. -T +300). This option is intended for debugging/testing only.

-v | –version

Print version information.

24.107.5. Signals#

SIGTERM

Sending a SIGTERM to the process will cause it to shutdown cleanly.

24.107.6. Exit Status#

0

Successful termination.

1

An operational failure occurred.

2

The command-line arguments are invalid.

4

Required database access is unavailable.

5

Required templates or single-page application resources are unavailable.

6

A required configuration setting is missing or invalid.

9

A hard failure occurred. Automatic restart should be suppressed until an operator has intervened.

24.107.7. See Also#

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

24.107.8. Bugs#

Report bugs by using Mantis https://bugs.taler.net/ or by sending electronic mail to <taler@gnu.org>