aboutsummaryrefslogtreecommitdiffstats
path: root/api.sr.ht/installation.md
diff options
context:
space:
mode:
authorAdnan Maolood <me@adnano.co>2022-07-07 11:38:43 -0400
committerDrew DeVault <sir@cmpwn.com>2022-07-07 17:39:26 +0200
commit478d096cf0eaaac2cc4399671725768bf348d2ed (patch)
treefbad2ff13580559a83fba8614612a4e8c05a2518 /api.sr.ht/installation.md
parentfc898d216b2fcab75c3f214f41676f2a6fb80b75 (diff)
downloadsr.ht-docs-478d096cf0eaaac2cc4399671725768bf348d2ed.tar.gz
Initial api.sr.ht documentation
Diffstat (limited to 'api.sr.ht/installation.md')
-rw-r--r--api.sr.ht/installation.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/api.sr.ht/installation.md b/api.sr.ht/installation.md
new file mode 100644
index 0000000..d57ad2e
--- /dev/null
+++ b/api.sr.ht/installation.md
@@ -0,0 +1,24 @@
+---
+title: api.sr.ht Installation
+---
+
+This document covers the installation steps for api.sr.ht, the GraphQL API
+gateway.
+
+# Installation
+
+Install the `api.sr.ht` package.
+
+## Daemons
+
+- `api.sr.ht` — The GraphQL API gateway
+
+## Maintenance
+
+The gateway does not maintain any state except for the federated graph it
+constructs by merging the GraphQL APIs of each service.
+
+If polling is configured, the gateway will periodically poll the GraphQL API of
+each service to check for changes to the schema and rebuild the merged schema if
+necessary. Otherwise, the gateway will need to be manually restarted to rebuild
+the merged schema.