Scroll to navigation

PRIVATEBIN.CONF(5) Privatebin Manual PRIVATEBIN.CONF(5)

NAME

privatebin.conf – privatebin CLI configuration file.

DESCRIPTION

The privatebin(1) command line interface create paste to an PrivateBin instance configured in the config.json.

FORMAT

Top level object keys:

The default value of open discussion for a paste.
The default value of burn after reading for a paste.
The default formatter for a paste.
The default time to live for a paste.
Enable GZip the paste data.
Skip TLS certificate verification when connecting to the privatebin instance.
The extra HTTP header fields to include in the request sent.
The list of bin instances.

The bin object format:

The name of the bin instance.
The url of the bin instance.
The basic auth configuration of the bin instance.
The default time to live for a paste.
The default value of open discussion for a paste.
The default value of burn after reading for a paste.
The formatter for the paste.
GZip the paste data.
Skip TLS certificate verification when connecting to the privatebin instance.
The extra HTTP header fields to include in the request sent.

The auth object format:

The basic auth username.
The basic auth password.

EXAMPLES

Minimal privatebin configuration file:

{


    "bin": [


        {


            "name": "", // default


            "host": "https://privatebin.net"


        }


    ]
}

A bit more complete configuration file:

{


    "bin": [


        {


            "name": "example",


            "host": "bin.example.com",


            "auth": {


                "username": "john.doe",


                "password": "s$cr$t"


            },


            "formatter": "markdown",


            "burn-after-reading": false


        },


        {


            "name": "",


            "host": "https://privatebin.net"


            "extra-header-fields": {


                "Foo": "Bar",


            },


        },


    ],


    "burn-after-reading": true
}

FILES

~/.config/privatebin/config.json
Default location of the privatebin configuration. The file has to be created manually as it is not installed with a standard installation.

AUTHORS

Bryan Frimin.

September 8, 2025 2.1.1