summaryrefslogtreecommitdiffstats
path: root/extra/adenosine-pds.1.scdoc
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2022-11-11 13:33:16 -0800
committerBryan Newbold <bnewbold@robocracy.org>2022-11-11 13:33:16 -0800
commit33368b57aa077ac13448f4d4927dd8a77934f763 (patch)
tree03848906f726b308f493b50cca27af5aa239ae21 /extra/adenosine-pds.1.scdoc
parent6a23af4d35eb87f4cfd7c70371a4f6f6cd87dad8 (diff)
downloadadenosine-33368b57aa077ac13448f4d4927dd8a77934f763.tar.gz
adenosine-33368b57aa077ac13448f4d4927dd8a77934f763.zip
pds: manpage, shell completions
Diffstat (limited to 'extra/adenosine-pds.1.scdoc')
-rw-r--r--extra/adenosine-pds.1.scdoc78
1 files changed, 78 insertions, 0 deletions
diff --git a/extra/adenosine-pds.1.scdoc b/extra/adenosine-pds.1.scdoc
new file mode 100644
index 0000000..750a176
--- /dev/null
+++ b/extra/adenosine-pds.1.scdoc
@@ -0,0 +1,78 @@
+adenosine-pds(1) "adenosine PDS Server Manual Page"
+
+# NAME
+
+adenosine-pds: small-world atproto.com Personal Data Server
+
+# SYNOPSIS
+
+adenosine-pds [OPTIONS] <COMMAND> <ARGS>
+
+# DESCRIPTION
+
+This is a simple, enthusiast-grade AT Protocol (atproto.com) personal data
+server ("PDS") implementation. It targets "small-world" uses cases of the
+protocol, for example personal or organizational self-hosting.
+
+This is a work-in-progress, is not spec-compliant, will not be
+backwards/forwards compatible, and does not have an upgrade/migration path.
+
+# COMMANDS
+
+*generate-secret*
+ Creates a new random secret key for PDS use
+
+*serve* [OPTIONS]
+ Runs the server. See options below
+
+*import* <car-path> [--alias <alias>]
+ Loads a CAR file into the repository blockstore
+
+*inspect*
+ Prints information about repositories in the blockstore (likely to deprecate)
+
+
+# OPTIONS
+
+*-h, --help*
+ Prints help information
+
+*-V, --version*
+ Prints version information
+
+*-v, --verbose*
+ Pass many times for more log output
+ By default, it'll only report errors. Passing `-v` one time also prints warnings, `-vv` enables info logging, `-vvv` debug, and `-vvvv` trace.
+
+*--atp-db <path>* [env: ATP_ATP_DB]
+ File path of sqlite database holding system/application data
+
+*--block-db <path>* [env: ATP_BLOCK_DB]
+ File path of sqlite database holding repository data (blockstore)
+
+## SERVE OPTIONS
+
+*--homepage-handle <homepage-handle>* [env: ATP_PDS_HOMEPAGE_HANDLE]
+ Optionally, override domain name check and force the homepage to display the account page for this handle
+
+*--invite-code <invite-code>* [env: ATP_PDS_INVITE_CODE]
+ Optionally, require an invite code to sign up. This is just a single secret value
+
+*--pds-secret-key <pds-secret-key>* [env: ATP_PDS_SECRET_KEY]
+ Secret key, encoded in hex. Use 'generate-secret' to create a new one
+
+*--port <port>* [env: ATP_PDS_PORT] [default: 3030]
+ Localhost port to listen on
+
+*--public-url <public-url>* [env: ATP_PDS_PUBLIC_URL]
+ A "public URL" for the PDS gets embedded in DID documents. If one is not
+ provided, a localhost value will be used, which will not actually work for
+ inter-PDS communication
+
+*--registration-domain <registration-domain>* [env: ATP_PDS_REGISTRATION_DOMAIN]
+ If provided, allow registration for the given base domain name
+
+
+# GETTING STARTED
+
+TODO