Troubleshooting
Common issues, that you may encounter are listed here, a fix, if available, will be there too. If you get an issue or error, that isn't listed here please open a new issue. Please make sure to fill out all the information, that is requested in the templates!
Any errors, that you may encounter during the installation of OctoDash.
You've most likely exceeded the GitHub Rate Limit, therefore the newest release can't be retrieved from the server.
Wait an hour until your Rate Limit gets reset.
You are getting several errors during the installation of OctoDash.
Please update your software to the newest version first and try reinstalling
OctoDash is not starting automatically, even though you installed it via the normal script.
Make sure you are logged in (auto-login can be enabled with the raspi-config tool). If that does not fix the issue make sure you can start OctoDash via the command octodash (you may need to execute export DISPLAY=:0 and ratpoison beforehand).
This issue comes up on some systems and prevents OctoDash from starting up correctly.
Fix the Xorg permission with sudo chmod ug+s /usr/lib/xorg/Xorg and restart your Raspberry
You ran the installing script and restarted your Pi, but rather than seeing OcotDash you're just getting some error messages.
If you see something along the lines of cannot open display or -bash xinit: command not found please make sure that you have installed the correct drivers for your display (these are NOT included with OctoDash) and run the install script again for good measure.
If you are sure, that you have the correct drivers installed here are some other things to try (make sure to reboot after each step to see if it is working):
- Double Check that B2 is selected for the Boot Options in
raspi-config - Try reconfiguring your x11 server:
sudo dpkg-reconfigure x11-common - Install additional packages, which my be needed for OctoPi distrobutions:
sudo apt install libpam0g-dev libx11-dev - Install even more packages:
sudo apt install raspberrypi-ui-mods(please try the above first) - Allow any user to use xinit: Stackexchange
- Install Desktop Environment:
sudo /home/pi/scripts/install-desktop
Any errors, that you may encounter during the setup of OctoDash.
If you're unsure what to enter in those fields or you're getting errors.
Always try localhost or 127.0.0.1 for the host and 5000 for the port if you're running OctoDash on the same machine as OctoPrint. For more information about those values visit the setup guide.
Any errors, that you may encounter during the usage of OctoDash.
You're getting a message, telling you that your config is invalid alongside with some weird technical-looking things. This can either happen if you upgrade to many versions at a time (I'm trying to merge configs from the previous release, if possible, so if you're upgrading from 1.4.0 to 1.4.1 you should be fine, but if you're going directly to 1.4.2 you might run into this error)
If you're unsure about what the errors mean you can always just delete that file rm ~/.config/octodash/config.json and reboot your Pi. This will open the initial setup screen again and will create a new, valid config for you. All your configuration data for OctoDash will be lost, OctoPrints data isn't touched.
If you understand what needs to be changed in your config please go ahead and edit it with your favorite text editor. You can find the config at ~/.config/octodash/config.json.
If you want more information about the config / settings have a look here.
This issue can occur if your board is taking to long to boot up. OctoDash will try to connect 3 times in the time span of 15 seconds, which might not be enough for some boards to boot up.
Please try the fork of OctoPrint PortLister by @mikekschloz.
