PURRITO(1)

NAME
purrito - PurritoBin pastebin server

SYNOPSIS
purrito [-cdeghiklmnpsw] -d domain [-c public_cert_file] [-e dhparams_file] [-g slug_size] [-h] [-i bind_ip] [-k private_key_file] [-l] [-m max_paste_size] [-n server name] [-p bind_port] [-s storage_directory] [-w passphrase]

DESCRIPTION
The purrito server is a pastebin server for accepting files on multiple interfaces. It is designed to have very low memory and CPU requirements and on average requires 2-3 MB of RAM to run.

The options are as follows:

-d domain
    REQUIRED

    domain that will be used as prefix of returned paste

    NOTE: should be the full name, including trailing /

    e.g. https://bsd.ac/

-c public_cert_file
    DEFAULT: null

    Public key certificate to use if using SSL.

-e dhparams_file
    DEFAULT: null

    Diffie-Hellman prime file to use if using SSL.

-g slug_size
    DEFAULT: 7

    Length of the randomly generated alpha-numeric slug for the paste.

-h  show help and exit

-i bind_ip
    DEFAULT: 0.0.0.0, ::

    IP on which to listen for incoming connections. Can be specified multiple times for multiple ips. If more bind_ip options than bind_port options are specified, then the last bind_port option is used for all remaining bind_ip options.

-k private_key_file
    DEFAULT: null

    Private key certificate to use if using SSL.

-l  Enable listening using an SSL server. If enabled then the -k, -c, -n options should also be specified.

-m max_paste_size
    DEFAULT: 65536 (64KB)

    Maximum paste size to accept, in BYTES.

-n server_name
    DEFAULT: null

    server_name to be used if using SSL.

-p bind_port
    DEFAULT: 42069

    Port on which to listen for connections. Can be specified multiple times for multiple ports. If more bind_port options than bind_ip options are specified, then the last bind_ip is used for all remaining bind_port options.

-s storage_directory
    DEFAULT: /var/www/purritobin

    path to the storage_directory for storing the pastes

    NOTE: should exist prior to starting the server and should be writable by the user running purrito.

-w passphrase
    DEFAULT: null

    passphrase for unlocking the private_key_file file if it is locked.

EXAMPLES
Run the purrito server with the domain name set to https://bsd.ac :

        $ purrito -d https://bsd.ac/

Run an SSL server with the accepted domain, -n, for SSL:

        $ purrito -d https://bsd.ac/ -l -n bsd.ac \
            -c /etc/ssl/bsd.ac.crt -k /etc/ssl/private/bsd.ac.key

DIAGNOSTICS
purrito logs to syslog with the purritobin identity, along with the PID of the server.