Known issues

This Known issue list is for TerrariumPI version 3.X only! For TerrariumPI version 4.x go https://theyosh.github.io/TerrariumPI/faq/

---

Installer

It is a known issue that the installer sometimes has issues with installing the python libraries. This will result in a rather red screen.
When that happens, the only solution is to re-run the installer once more after the installation. It will then re-install the software and update the missing part due to the previous error

Slow / hanging restart after upgrade

When a new version is installed, the software will auto detect that and will run its upgrade steps. Which is also a database update. Most database updates are fast, but when there is a new X.Y.0 release, the database will do a cleanup. That will take a long time and during that time, the software is not running and waiting to complete.
Indication: 1.8GB database takes about 20 minutes to clean up.
A warning message is shown in the console.

Python3 numpy import error

If the following error is shown on the screen console, then the numpy modules needs to be downgraded.

ImportError: numpy.core.multiarray failed to import  
Traceback (most recent call last):  
  File "/home/pi/TerrariumPI/terrariumPI.py", line 20, in <module>  
    from terrariumEngine import terrariumEngine  
  File "/home/pi/TerrariumPI/terrariumEngine.py", line 30, in <module>  
    from terrariumWebcam import terrariumWebcam, terrariumWebcamSourceException  
  File "/home/pi/TerrariumPI/terrariumWebcam.py", line 6, in <module>  
    import cv2  
  File "/usr/local/lib/python3.5/dist-packages/cv2/__init__.py", line 3, in <module>  
    from .cv2 import *  
ImportError: numpy.core.multiarray failed to import  

Run the following command: sudo pip3 uninstall -y numpy

Raspberry PI Zero

It is known that with Raspberry PI Zero, you need to run the software as user root. This is needed to readout the GPIO pins. It is unclear why this is needed. But at the moment, there is no work around for it.

So if you use a Raspberry PI Zero, you need to run the software as user root. This can be done by changing the startup file (start.sh) from:

# Some settings
RUN_AS_USER="pi"

to

# Some settings
RUN_AS_USER="root"