ordinary-start(1)

NAME
ordinary-start - start the app, locally

SYNOPSIS
ordinary start [--provision] [--port] [--redirect-port] [--insecure] [--insecure-cookies] [--log-ttl-hours] [--log-rotation-file-size] [--log-rotation-mins] [--log-headers] [--log-ips] [--redacted-header-hash] [--danger-dns-no-verify] [--data-dir] [--stored-logs] [--stdio-logs] [--stdio-logs-fmt] [--journald-logs] [--log-level] [-p|--project] [--api-domain] [--log-sizes] [--stdio-logs-timing] [-d|--disable-defaults] [--danger-accept-invalid-certs] [-v|--verbose]... [-q|--quiet]... [--pretty] [-h|--help] [-V|--version]

DESCRIPTION
start the app, locally

OPTIONS

--provision <PROVISION> [default: localhost]
    what mode TLS certs should be provisioned in
    Possible values:

    •   staging

    •   production

    •   localhost

--port <PORT>
    specify HTTP(s) port for server

--redirect-port <REDIRECT_PORT>
    specify HTTP port for server when running in secure mode

--insecure
    run without HTTPS

--insecure-cookies
    run with insecure cookies

--log-ttl-hours <LOG_TTL_HOURS> [default: 72]
    max period of time logs are stored

--log-rotation-file-size <LOG_ROTATION_FILE_SIZE> [default: 10000000]
    max size (in bytes) per log file

--log-rotation-mins <LOG_ROTATION_MINS> [default: 60]
    max amount of time a log file is appended to before being compressed and stored

--log-headers
    whether HTTP request and response headers are logged

--log-ips
    whether IP Addresses are logged with HTTP requests

--redacted-header-hash <REDACTED_HEADER_HASH> [default: none]
    "none" | "blake2" | "blake3"

--danger-dns-no-verify
    set to `true` to bypass verification of proxy domain and CNAME DNS TXT records. **IMPORTANT**: should ONLY be used for local development and testing.

--data-dir <DATA_DIR> [default: ~/.ordinary]
    specify the data directory

--stored-logs
    persists JSON formatted log lines to <data-dir>/logs/<domain>/

--stdio-logs
    logs events to stdio

--stdio-logs-fmt <STDIO_LOGS_FMT> [default: json]
    how to format stdio logs
    Possible values:

    •   concise

    •   pretty

    •   json

--journald-logs
    logs events to `journald` (only works on Linux distros that use `systemd`)

--log-level <LOG_LEVEL> [default: info]
    base log level for every component
    Possible values:

    •   error

    •   warn

    •   info

    •   debug

    •   trace

-p, --project <PROJECT> [default: .]
    project path

--api-domain <API_DOMAIN>
    should only be necessary with localhost or when addressing by IP

--log-sizes
    whether storage and certain payload sizes are logged

--stdio-logs-timing
    whether span timing is logged

-d, --disable-defaults
    disables these defaults set for development: `--stdio-logs` `--stdio-logs-fmt concise` `--insecure` `--insecure-cookies`

--danger-accept-invalid-certs
    DANGER: only use when working with self-signed localhost certs

-v, --verbose
    Increase logging verbosity

-q, --quiet
    Decrease logging verbosity

--pretty
    whether to pretty print events to stdio

-h, --help
    Print help (see a summary with '-h')

-V, --version
    Print version

VERSION
v0.8.3