NAME
    public-inbox-init - create or reinitialize a public-inbox

SYNOPSIS
    public-inbox-init [OPTIONS] NAME INBOX_DIR HTTP_URL ADDRESS [ADDRESS..]

DESCRIPTION
    Creates an empty public-inbox or reinitializes an existing one. It
    updates "~/.public-inbox/config" by creating a "[publicinbox "NAME"]"
    section where "publicinbox.NAME.inboxdir" is "INBOX_DIR",
    "publicinbox.NAME.url" is "HTTP_URL", and "publicinbox.NAME.address" is
    "ADDRESS". Multiple addresses may be specified for inboxes with multiple
    addresses.

OPTIONS
    -V, --version FORMAT_VERSION
        Specify 2 here to use the scalable public-inbox-v2-format(5) if you
        have DBD::SQLite installed.

        The default is 1 for the old public-inbox-v1-format(5), but 2 is
        strongly recommended for scalability if you have DBD::SQLite.

        Default: 1

    --indexlevel <basic|medium|full>
        Controls the indexing level for public-inbox-index(1)

        See public-inbox-config(5) for more information.

        Default: "full"

    -S, --skip-epoch
        For "-V2" (public-inbox-v2-format(5)) inboxes only, this option
        allows archivists to publish incomplete archives with newer mail
        while allowing "0.git" (or "1.git" and so on) epochs to be
        added-after-the-fact (without affecting "git clone" followers).

        Default: unset, no epochs are skipped

ENVIRONMENT
    PI_CONFIG
            Used to override the default "~/.public-inbox/config" value.

LIMITATIONS
    This tool predates NNTP support in public-inbox and is missing
    "newsgroup" and many of the options documented in
    public-inbox-config(5). See public-inbox-config(5) for all the options
    which may be applied to a given inbox.

CONTACT
    Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>

    The mail archives are hosted at <https://public-inbox.org/meta/> and
    <http://hjrcffqmbrq6wope.onion/meta/>

COPYRIGHT
    Copyright 2019 all contributors <mailto:meta@public-inbox.org>

    License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>

SEE ALSO
    git-init(1), git-config(1), public-inbox-v1-format(5),
    public-inbox-v2-format(5)