.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH ordinary-start 1 "start 0.6.0"
.SH NAME
ordinary\-start \- start the app, locally
.SH SYNOPSIS
\fBordinary start\fR [\fB\-\-provision\fR] [\fB\-\-port\fR] [\fB\-\-redirect\-port\fR] [\fB\-\-insecure\fR] [\fB\-\-insecure\-cookies\fR] [\fB\-\-log\-ttl\-hours\fR] [\fB\-\-log\-rotation\-file\-size\fR] [\fB\-\-log\-rotation\-mins\fR] [\fB\-\-log\-headers\fR] [\fB\-\-log\-ips\fR] [\fB\-\-redacted\-header\-hash\fR] [\fB\-\-data\-dir\fR] [\fB\-\-stored\-logs\fR] [\fB\-\-stdio\-logs\fR] [\fB\-\-stdio\-logs\-fmt\fR] [\fB\-\-journald\-logs\fR] [\fB\-\-log\-level\fR] [\fB\-\-log\-sizes\fR] [\fB\-p\fR|\fB\-\-project\fR] [\fB\-\-api\-domain\fR] [\fB\-\-stdio\-logs\-timing\fR] [\fB\-d\fR|\fB\-\-disable\-defaults\fR] [\fB\-\-danger\-accept\-invalid\-certs\fR] [\fB\-v\fR|\fB\-\-verbose\fR]... [\fB\-q\fR|\fB\-\-quiet\fR]... [\fB\-\-pretty\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR]
.SH DESCRIPTION
start the app, locally
.SH OPTIONS
.TP
\fB\-\-provision\fR \fI<PROVISION>\fR [default: localhost]
what mode TLS certs should be provisioned in
.br
.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
staging
.IP \(bu 2
production
.IP \(bu 2
localhost
.RE
.TP
\fB\-\-port\fR \fI<PORT>\fR
specify HTTP(s) port for server
.TP
\fB\-\-redirect\-port\fR \fI<REDIRECT_PORT>\fR
specify HTTP port for server when running in secure mode
.TP
\fB\-\-insecure\fR
run without HTTPS
.TP
\fB\-\-insecure\-cookies\fR
run with insecure cookies
.TP
\fB\-\-log\-ttl\-hours\fR \fI<LOG_TTL_HOURS>\fR [default: 72]
max period of time logs are stored
.TP
\fB\-\-log\-rotation\-file\-size\fR \fI<LOG_ROTATION_FILE_SIZE>\fR [default: 10000000]
max size (in bytes) per log file
.TP
\fB\-\-log\-rotation\-mins\fR \fI<LOG_ROTATION_MINS>\fR [default: 60]
max amount of time a log file is appended to before being compressed and stored
.TP
\fB\-\-log\-headers\fR
whether HTTP request and response headers are logged
.TP
\fB\-\-log\-ips\fR
whether IP Addresses are logged with HTTP requests
.TP
\fB\-\-redacted\-header\-hash\fR \fI<REDACTED_HEADER_HASH>\fR [default: none]
"none" | "blake2" | "blake3"
.TP
\fB\-\-data\-dir\fR \fI<DATA_DIR>\fR [default: ~/.ordinary]
specify the data directory
.TP
\fB\-\-stored\-logs\fR
persists JSON formatted log lines to <data\-dir>/logs/<domain>/
.TP
\fB\-\-stdio\-logs\fR
logs events to stdio
.TP
\fB\-\-stdio\-logs\-fmt\fR \fI<STDIO_LOGS_FMT>\fR [default: json]
how to format stdio logs
.br
.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
concise
.IP \(bu 2
pretty
.IP \(bu 2
json
.RE
.TP
\fB\-\-journald\-logs\fR
logs events to `journald` (only works on Linux distros that use `systemd`)
.TP
\fB\-\-log\-level\fR \fI<LOG_LEVEL>\fR [default: info]
base log level for every component
.br
.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
error
.IP \(bu 2
warn
.IP \(bu 2
info
.IP \(bu 2
debug
.IP \(bu 2
trace
.RE
.TP
\fB\-\-log\-sizes\fR
whether storage and certain payload sizes are logged
.TP
\fB\-p\fR, \fB\-\-project\fR \fI<PROJECT>\fR [default: .]
project path
.TP
\fB\-\-api\-domain\fR \fI<API_DOMAIN>\fR
should only be necessary with localhost or when addressing by IP
.TP
\fB\-\-stdio\-logs\-timing\fR
whether span timing is logged
.TP
\fB\-d\fR, \fB\-\-disable\-defaults\fR
disables these defaults set for development: `\-\-stdio\-logs` `\-\-stdio\-logs\-fmt concise` `\-\-insecure` `\-\-insecure\-cookies`
.TP
\fB\-\-danger\-accept\-invalid\-certs\fR
DANGER: only use when working with self\-signed localhost certs
.TP
\fB\-v\fR, \fB\-\-verbose\fR
Increase logging verbosity
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Decrease logging verbosity
.TP
\fB\-\-pretty\fR
whether to pretty print events to stdio
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
\fB\-V\fR, \fB\-\-version\fR
Print version
.SH VERSION
v0.6.0