Megathread for MineOS webui issues

Community
3

Webui service

How do I know the webui is running?

root@mineos games/minecraft# netstat -tnl | grep 8443
tcp        0      0 0.0.0.0:8443            0.0.0.0:*               LISTEN

Check for tcp, 0.0.0.0:8443. This indicates it’ll work on IPv4 and is listening on all interfaces on the right port.

How else can I check?

root@mineos ~# ps -aux | grep node
root       989  1.9  4.7 1302200 96852 ?       Sl   17:58   0:13 /usr/bin/node webui.js
root      1605  0.0  0.0  11128   976 pts/0    S+   18:10   0:00 grep --color=auto node

Check for webui.js. Also take note that root is running your expected binary, which in this case is /usr/bin/node but can vary depending on your nodejs installation choices.

How else can I check?

root@mineos games/minecraft# supervisorctl status mineos
mineos                           RUNNING    pid 989, uptime 0:30:27

This is a supervisord process, but depending on your installation, you might also find out this process via systemctl mineos status.

How else can I check?

will@willonubuntu:~$  curl -k -c cookie.txt -d "username=mc" -d "password=Mcpassword1" https://12.34.56.78:8443/auth                                             
Found. Redirecting to /admin/index.html
will@willonubuntu:~$ curl -k -b cookie.txt https://12.34.56.78:8443/admin/index.html
<!DOCTYPE html>
<!--[if lt IE 7]>      <html class="no-js lt-ie9 lt-ie8 lt-ie7"> <![endif]-->
<!--[if IE 7]>         <html class="no-js lt-ie9 lt-ie8"> <![endif]-->
<!--[if IE 8]>         <html class="no-js lt-ie9"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" ng-app="mineos"> <!--<![endif]-->
<head>

This can be done from both the local server to check if it’s running, or from a remote server to test connectivity!

This is definitely the least popular option, but actually is confirming that the webui is connectable and that the authentication stack is working. Still, the other options are likely sufficient (knowing the webui is up).

The webui keeps crashing! What can I do?

  1. Update to a recent commit (or reset your scripts)
  2. Restart the background service to load the new commit! supervisorctl restart mineos
  3. Look at /var/log/mineos.log and share a copy with us (there’s nothing in there that’s unsafe to share, but you can blur out the ip addresses if you want)