@@ 520,3 520,40 @@ dirs = [
<p>
<span class="bold">Note that there is no offline support</span> since MousikóFídi requires network access to the server in order to download tracks.
</p>
+
+<h2>Troubleshooting</h2>
+
+What to do when MousikóFídi isn't working right.
+
+<h3>MousikóFídi Won't Start</h3>
+
+<p>
+ Any problems will be noted in the application log. Where this is depends on how you are running MousikóFídi; the easiest way to see any problems would be to run the dev server:
+</p>
+
+<pre><code># Become the app user, if applicable:
+sudo su - fidi
+
+# Run the dev server:
+mousikofidi --dev</code></pre>
+
+<p>
+ If there's a problem that is stopping MousikóFídi from running, it will be mentioned:
+</p>
+
+<pre><code>$ mousikofidi --dev
+ * Serving Flask app "mousikofidi" (lazy loading)
+ * Environment: development
+ * Debug mode: on
+ * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
+ * Restarting with stat
+[2020-10-03 14:29:32,363] DEBUG in mousikofidi: Reading User Config: /opt/fidi/.config/fidi/config.toml
+[2020-10-03 14:29:32,363] ERROR in mousikofidi: The '[player]' section is missing from your config file!
+[2020-10-03 14:29:32,363] ERROR in mousikofidi: Add it or rename your existing file to have a new, valid one generated!
+[2020-10-03 14:29:32,363] ERROR in mousikofidi: Exiting now because we are unable to do anything...</code></pre>
+
+<h3>How To Get Help</h3>
+
+<p>
+ If there's some other problem, please feel free to reach out via <a href="https://lists.sr.ht/~hristoast/mousikofidi">the mailing list</a> or by <a href="https://todo.sr.ht/~hristoast/mousikofidi">opening a bug report</a>. You can also join <a href="https://demo.mousikofidi.info/about#get-help">#mousikofidi on irc.freenode.net</a>, please be patient if you don't get a response right away.
+</p>