((h2 (@ (id . "zettelstore-run")) (code "zettelstore run")) (p "This" " " "starts" " " "the" " " "web" " " "service.") (pre (code "zettelstore run [-a PORT] [-c CONFIGFILE] [-d DIR] [-debug] [-p PORT] [-r] [-v]")) (dl (dt (a (@ (id . "a")) (kbd "-a PORT"))) (dd (p "Specifies" " " "the" " " "TCP" " " "port" " " "through" " " "which" " " "you" " " "can" " " "reach" " " "the" " " (a (@ (href . "00001004100000")) "administrator" " " "console") "." " " "See" " " "the" " " "explanation" " " "of" " " (a (@ (href . "00001004010000#admin-port")) (kbd "admin-port")) " " "for" " " "more" " " "details.")) (dt (a (@ (id . "c")) (kbd "-c CONFIGFILE"))) (dd (p "Specifies" " " (kbd "CONFIGFILE") " " "as" " " "a" " " "file," " " "where" " " (a (@ (href . "00001004010000")) "startup" " " "configuration" " " "data") " " "is" " " "read." " " "It" " " "is" " " "ignored," " " "when" " " "the" " " "given" " " "file" " " "is" " " "not" " " "available," " " "nor" " " "readable.") (p "Default:" " " "tries" " " "to" " " "read" " " "the" " " "following" " " "files" " " "in" " " "the" " " (@L (@H "“") "current" " " "directory" (@H "”")) ":" " " (kbd "zettelstore.cfg") "," " " (kbd "zsconfig.txt") "," " " (kbd "zscfg.txt") "," " " (kbd "_zscfg") "," " " "and" " " (kbd ".zscfg") ".")) (dt (a (@ (id . "d")) (kbd "-d DIR"))) (dd (p "Specifies" " " (kbd "DIR") " " "as" " " "the" " " "directory" " " "that" " " "contains" " " "all" " " "zettel.") (p "Default" " " "is" " " (kbd "./zettel") " " "(" (kbd ".\\zettel") " " "on" " " "Windows)," " " "where" " " (kbd ".") " " "denotes" " " "the" " " (@L (@H "“") "current" " " "directory" (@H "”")) ".")) (dt (a (@ (id . "debug")) (kbd "-debug"))) (dd (p "Allows" " " "better" " " "debugging" " " "of" " " "the" " " "internal" " " "web" " " "server" " " "by" " " "disabling" " " "any" " " "timeout" " " "values." " " "You" " " "should" " " "specify" " " "this" " " "only" " " "as" " " "a" " " "developer." " " "Especially" " " "do" " " "not" " " "enable" " " "it" " " "for" " " "a" " " "production" " " "server.") (p (a (@ (class . "external") (href . "https://blog.cloudflare.com/exposing-go-on-the-internet/#timeouts")) "https://blog.cloudflare.com/exposing-go-on-the-internet/#timeouts") " " "contains" " " "a" " " "good" " " "explanation" " " "for" " " "the" " " "usefulness" " " "of" " " "sensitive" " " "timeout" " " "values.")) (dt (a (@ (id . "p")) (kbd "-p PORT"))) (dd (p "Specifies" " " "the" " " "integer" " " "value" " " (kbd "PORT") " " "as" " " "the" " " "TCP" " " "port," " " "where" " " "the" " " "Zettelstore" " " "web" " " "server" " " "listens" " " "for" " " "requests.") (p "Default:" " " "23123.") (p "Zettelstore" " " "listens" " " "only" " " "on" " " (kbd "127.0.0.1") "," " " "e.g." " " "only" " " "requests" " " "from" " " "the" " " "current" " " "computer" " " "will" " " "be" " " "processed." " " "If" " " "you" " " "want" " " "to" " " "listen" " " "on" " " "network" " " "card" " " "to" " " "process" " " "requests" " " "from" " " "other" " " "computer," " " "please" " " "use" " " (a (@ (href . "00001004010000#listen-addr")) (kbd "listen-addr")) " " "of" " " "the" " " "configuration" " " "file" " " "as" " " "described" " " "below.")) (dt (a (@ (id . "r")) (kbd "-r"))) (dd (p "Puts" " " "the" " " "Zettelstore" " " "in" " " "read-only" " " "mode." " " "No" " " "changes" " " "are" " " "possible" " " "via" " " "the" " " (a (@ (href . "00001014000000")) "web" " " "user" " " "interface") " " "/" " " "via" " " "the" " " (a (@ (href . "00001012000000")) "API") ".") (p "This" " " "allows" " " "to" " " "publish" " " "your" " " "content" " " "without" " " "any" " " "risks" " " "of" " " "unauthorized" " " "changes.")) (dt (a (@ (id . "v")) (kbd "-v"))) (dd (p "Be" " " "more" " " "verbose" " " "when" " " "writing" " " "logs."))) (p "Command" " " "line" " " "options" " " "take" " " "precedence" " " "over" " " (a (@ (href . "00001004010000")) "configuration" " " "file") " " "options."))