Add self-check command

docs/README.md

@@ -12,6 +12,8 @@
 
 - [Configuring service discovery via .well-known](configuring-well-known.md)
 
+- [Maintenance / checking if services work](maintenance-checking-services.md)
+
 - [Maintenance / upgrading services](maintenance-upgrading-services.md)
 
 - [Maintenance / upgrading PostgreSQL](maintenance-upgrading-postgres.md)

docs/configuring-well-known.md

@@ -81,4 +81,6 @@ Make sure to:
 
 ## Confirming it works
 
-No matter which method you've used to set up the well-known file, if you've done it correctly you should be able to see a JSON file at a URL like this: `https://matrix.<domain>/.well-known/matrix/client`.
+No matter which method you've used to set up the well-known file, if you've done it correctly you should be able to see a JSON file at a URL like this: `https://matrix.<domain>/.well-known/matrix/client`.
+
+You can also check if everything is configured correctly, by [checking if services work](maintenance-checking-services.md).

docs/installing.md

@@ -33,4 +33,5 @@ ansible-playbook -i inventory/hosts setup.yml --tags=start
 Now that the services are running, you might want to:
 
 - [create your first user account](registering-users.md)
-- or **finalize the installation process** by [Configuring service discovery via .well-known](configuring-well-known.md)
+- or **finalize the installation process** by [Configuring service discovery via .well-known](configuring-well-known.md)
+- or [Check if services work](maintenance-checking-services.md)

docs/maintenance-checking-services.md

@@ -0,0 +1,13 @@
+# Checking if services work
+
+This playbook can perform a check to ensure that you've configured things correctly and that services are running.
+
+To perform the check, run:
+
+```bash
+ansible-playbook -i inventory/hosts setup.yml --tags=self-check
+```
+
+If it's all green, everything is probably running correctly.
+
+Besides this self-check, you can also check your server using the [Federation Tester](https://neo.lain.haus/fed-tester/).