diff --git a/documentation/pubsub-messaging.md b/documentation/pubsub-messaging.md
index 2ffa6b3..9e7588c 100644
--- a/documentation/pubsub-messaging.md
+++ b/documentation/pubsub-messaging.md
@@ -89,3 +89,30 @@ $pubsub_account = [
 ];
 $config['helfi_api_base.api_accounts']['vault'][] = $pubsub_account;
 ```
+
+## Solving pubsub related problems
+
+If menus or news or other content doesn't update normally, you can verify that the pubsub service is working correctly
+
+### Artemis is not up on etusivu-instance
+- See that frontpage production has artemis pod up and running
+
+#### If the pod is not running
+- See if there is a pipeline to get it up again OR
+- Contact HiQ
+
+
+### Pubsub-process is not running
+- Go to any production site's cron pod
+  - run `ps aux`, you should see pubsub related process on the list
+
+#### If the process is not running
+- Short term solution is to run `drush cr` to force the site to fetch new data.
+- You can run production deployment to get it running again.
+
+
+### Bad credentials
+- Go to any cron pod and look for authorization error
+
+#### Update the credentials
+- Go and update the pubsub-vault credentials