~hristoast/mousikofidi

2258b57e25eed989724623579e09346db7b0bed2 — Hristos N. Triantafillou 6 months ago e9eb483
Troubleshooting tips, how to get help
1 files changed, 37 insertions(+), 0 deletions(-)

M site/user_guide.html
M site/user_guide.html => site/user_guide.html +37 -0
@@ 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>