taler-docs

Documentation for GNU Taler components, APIs and protocols
Log | Files | Refs | README | LICENSE

paivana-httpd.1.rst (1486B)


      1 paivana-httpd(1)
      2 ################
      3 
      4 .. only:: html
      5 
      6    Name
      7    ====
      8 
      9    **paivana-httpd** - reverse-proxy paywall
     10 
     11 
     12 Synopsis
     13 ========
     14 
     15 **paivana-httpd**
     16 [**-h**_|_**--help**]
     17 [**-n**_|_**--no-payment**]
     18 [**-u** *BYTES*_|_**--max-upload=**\ \ *BYTES*]
     19 [**-v**_|_**--version**]
     20 
     21 Description
     22 ===========
     23 
     24 **paivana-httpd** is a reverse proxy that requires the client to
     25 make a payment using GNU Taler before forwarding the request.
     26 The reverse proxy uses a GNU Taler merchant backend to process
     27 payments and also learns which websites require payment and how
     28 much the prices are. Thus, the main configuration is done within
     29 the Taler merchant backend.
     30 
     31 paivana-httpd will simply open an HTTP socket, listen for incoming
     32 requests, and if they are paid (or do not require payment) forward
     33 them to the respective webserver configured.
     34 
     35 Its options are as follows:
     36 
     37 **-h** | **--help**
     38    Print short help on options.
     39 
     40 **-n** | **-no-payment**
     41    Disable payment, only act as a reverse proxy that does nothing.
     42    Useful to temporarily disable the paywall or to test the
     43    reverse proxy itself.
     44 
     45 **-u** *BYTES* |  **--max-upload=**\ \ *BYTES*
     46    Set the maximum upload size allowed by the reverse proxy.
     47    Only applies to the body size (the HTTP header has a separate limit).
     48 
     49 **-v** | **--version**
     50    Print version number.
     51 
     52 See Also
     53 ========
     54 
     55 taler-merchant-httpd(1), paivana.conf(5)
     56 
     57 Bugs
     58 ====
     59 
     60 Report bugs by using https://bugs.taler.net or by sending electronic
     61 mail to <taler@gnu.org>.