4.14.0: End of year release: Weather changes 🎄🎆

This release will bring some changes in the weather part of TerrariumPI. Thanks to @GamingLPyt we have now support for OpenMeteo.com weather data.
And that lead to a refactor the total weather code internally. Not something you will notice on the outside… I hope 😁

Also fixed some RTSP and USB webcams on Bookworm.

OpenMeteo.com weather data 🌤

This is a free service which does not need an account. You need to know the latitude and longitude of your location. And than construct the following url below:

https://api.open-meteo.com/v1/forecast?latitude=[LAT]&longitude=[LONG]

More at the weather documentation page

Other updates

• Updates all NodeJS, Python and Ruby libraries for the GUI, TerrariumPI and the documentation.
• Updated the documentation at various pages. Mostly adding more information or corrections.

https://theyosh.github.io/TerrariumPI/posts/2025/11/09/release-terrariumpi-v-4-14-0/

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.13.1...4.14.0

4.13.1: Reconnect the dashboard / Bye bye `:latest`

Due to external package updates the web socket connection was broken on Bookworm installations (both docker as manual). This resulted in an offline state in the browser, and all the counters at the top of the dashboard at zero. No bueno…

So the web socket code is has been rewritten so it is working again. And the code is now also more robust for the future.
No more Docker :latest

With version 4.13.0 there was no :latest image any more. This was not intentional, but happened. And actually it is better. There are people mixing OS and container versions. And even it does work, it makes it very hard to debug when things do not work.

So now it is official. There is no more :latest tag for the Docker images. This way, you have to pick a specific version. Which makes it a bit easier to manage issues and support.

If for what reason you need to use the old :latest version, stick with :X-buster-java version. But keep in mind: This is an old version, which is not even supported anymore at all. It works as is…

https://theyosh.github.io/TerrariumPI/posts/2025/11/09/release-terrariumpi-v-4-13-1/

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

What's Changed

• Bump pip from 25.2 to 25.3 by @dependabot[bot] in #1037

Full Changelog: 4.13.0...4.13.1

4.13.0: Lots of small updates makes a big release

With this release we have a lot of small fixes and some more noticeable. All together it does make a rather big release.
So here they are.

New sensor AHTx0

We now support a new temperature and humidity sensor AHTx0. It is an I2C based sensor which seams not that expansive but still cheap. Make sure you rerun the installer when you have it manually installed. It needs new libraries to work.

Refactoring Kasa hardware

In the past we only supported relays and light bulbs or light strips. Now we should also be able to handle all other Kasa devices. Even dimmable lights are now supported, but we do not support the dimming of the light (yet). Only on and off actions should work.

New language Slovakia

We have a new language which is Slovakia. This has been translated by @misoteplan. Big thank you! 👍

Update graphs

It is now possible to specify a default graph period other than a single day. So you could now select a week period as a default for all your graphs. But be careful, because if you have a lot of graphs on a single page, it can overwhelm the database. So take care when you select a different period.

Another update is that we now have an hour period as well. That will show the data of the last hour.

And on the dashboard the average graphs should not drop or spike at the last minute when not all sensor data is available.

And there is an attempt to make the gauge graphs more responsive when you change the alarm or limit values of a sensor.

Bookworm updates

It turned out that the RPI webcam was not well working under Bookworm OS. This is now fixed, and the Raspberry cam is not fully working again in Bookworm. For both still image and live streaming.

Also it was possible to select a not supported white balancing, and that crashed the RPI camera. And after changing it, only a restart of TerrariumPI would start the camera again. This has been fixed that a webcam now is always restarted after changing the settings. This should take care of failing RPI camera when unsupported white balance is selected. This is only happening with Bookworm OS.

And after some other testing, it turns out that Bluetooth is probably not working at all 🙁. We where at the moment unable to connect to a MiFlora bluetooth sensor. The bluetooth library as been reverted back to the original used and hopefully this will not break anything. 🤞
A more detailed state of Bookworm OS support is in the making.

Other updates

• Updates all NodeJS, Python and Ruby libraries for the GUI, TerrariumPI and the documentation.-
• Updated the documentation at various pages. Mostly adding more information or corrections.
• Downgraded Python package psutil due to broken Piwheels
• Added new setting to skip auto discovering new hardware during startup.
• Fixed creating a new calendar the first time TerrariumPI is started.
• Added OS version to the logging.
• Optimized enclosure updates when a relays is toggled.
• Docker build fixes for Bookworm images.
• Fixed version update stored in the database.
• Documentation updates
• Fix log file rights after first installation.

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.12.5...4.13.0

4.12.5: Summer release fix

New gauge graph settings fix

With the new Gauge graph feature, we created a small bug. So we had to fix that, and after some tinkering and remarks on the Matrix channel, we have re-designed the gauge graph value settings. You can now just select which value you want to show on the gauge graphs.

Unfortunately there is no migration of the gauge settings values. So with this release you have to re-select the values you want to show. Sorry

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.12.4...4.12.5

4.12.4: Summer release, gauge updates and bug fixes

New gauge graph settings

In this release we have a new ‘feature’. You can now show the alarm values on the gauge graphs [#1016] This makes it easier to read your gauge graphs and see how close you are to an alarm value. You can find the setting on the settings page.

Support for location ID in weather settings

It is now also possible to enter a direct location ID from OpenWeatherMap.org.
It can happen that a place name is not unique in a country. If that is the case for you, you can now use a location ID so you can pick the correct city for weather data.
And updated the documentation as well about the usage of different API version.

Extra relay toggling logging

And we added some logging when a relay is toggled. So we are now sure that the relay is toggled when requested. Also this will make sure that you can see that Terrariumpi is retrying to toggle the relay when it fails. [#1015]

Bug fixes

Script dimmer relays

It was not possible to change the a script dimmer relay when it was added to TerrariumPI. In this release this is fixed. [#1014]

Bookworm live camera

Apparently some parameters used for live streaming in Bookworm was changed. This should now be fixed again.

General updates

This release will also update all external libraries to the latest versions.

What's Changed

• Bump requests from 2.32.3 to 2.32.4 by @dependabot[bot] in #1013

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.12.3...4.12.4

4.12.3: Multiple bugfixes and maintenance updates

After 6 months we have a new release. This release is what later, as the software is maturing. This results in less bugfixes and only updates for external libraries. But this release does fix multiple small bugs.

Read the full release news message here

What's Changed

• Bump nokogiri from 1.18.2 to 1.18.3 by @dependabot in #983
• Bump jinja2 from 3.1.5 to 3.1.6 by @dependabot in #986
• Bump json from 2.10.1 to 2.10.2 by @dependabot in #988
• Bump prismjs from 1.29.0 to 1.30.0 by @dependabot in #987
• Bump @sveltejs/kit from 2.20.5 to 2.20.6 by @dependabot in #998
• Bump nokogiri from 1.18.7 to 1.18.8 by @dependabot in #1000
• Bump setuptools from 78.1.0 to 78.1.1 by @dependabot in #1012

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.12.2...4.12.3

4.12.2: Happy holidays

Merry Christmas and a happy new year! 🎄🎆

A happy new year release! This release is a maintenance release which mainly updates the used libraries. And increased the weather logging a bit.

And just before this release bug #975 with the CHIRP sensor has been fixed.

Get the new version here.

Or, go the installation page in order to install Terrarium PI version.

What's Changed

• Bump @sveltejs/kit from 2.8.2 to 2.8.3 by @dependabot in #969

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.12.1...4.12.2

4.12.1: Webcam enhancements

In this release we added some new webcam features and fixes. The ‘big’ update is that we now can clear the webcam archive so that the SD card will not get 100% full. A full SD will crash TerrariumPI. If you want to set this up, make sure you manually clear first the majority of the files. Else the first delete action can take a long time and make TerrariumPI crash.

So now you can give an amount of days of archive to keep. Or just keep everything by leaving the value empty.

Also we found that the webcam notification where broken. They are now fixed. Now it should send out messages with pictures when you setup webcam notifications.

And we improved the motion detection of live streams a bit. In the past the change in time could trigger a motion, where you can end up with an image every update of 30 seconds. So now we exclude the area where the name and time is shown. And that will not trigger a motion anymore.

What's Changed

• Bump rexml from 3.3.8 to 3.3.9 by @dependabot in #964

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.12.0...4.12.1

4.12.0: Just a new release

Just a new release

This new release is not a big release. It has some bugfixes and logging improvements. One new improvement is that we now support Sonoff D1 Dimmer in DIY mode.

Sonoff D1 Dimmer DIY mode

Now it is possible to use the Sonoff D1 Dimmer in DIY mode. This makes it easier to add this dimmer to TerrariumPI. A big thanks to MakoShark2 for testing and helping with creating the code.

Improvements

Improved the light timer calculation when TerrariumPI is restarted after midnight, before the end of the current light period. Thanks to rossisbudda for finding this bug.

The logging has been improved to log now the correct hardware names. Due to a bug, not the correct hardware name was shown in the log.

Translations

The Spanish language is updated by nebu73.

Bug fixes

Fixed the logging in the TerrariumPI GUI when you where already logged in. There was an issue with correctly reading the authentication cookie.

Fixed a cookie saving issue due to deprecated code in the Bottle.py web server code.

Fixed installation on Bookworm OS. It was missing a SSL library. That has been fixed.

Documentation updates

Updated the Sonoff D1 Dimmer documentation about support for DIY mode.

Updated the backup, restoring and debug FAQ.

What's Changed

• Bump google-protobuf from 4.28.1 to 4.28.2 by @dependabot in #951

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.11.1...4.12.0

4.11.1: Maintenance update

Maintenance update

With this update we fix some small issues and updated all external libraries.

Updated the Docker builds to make them a bit faster and smaller in size.

Added some extra warnings at the documentation pages for the DHTXX sensors.

A new Portuguese translation is added by MakoShark2 and other languages are updated.

Fixes

Fixed a bug that when you are already logged in, the log lines did not show up fully in the log screen. #939

Removed all direct gevent functions. So it can also run without Gevent when needed in the future. Using monkey patch, we still use Gevent.

What's Changed

Read all about it at the release page

Upgrading

Use the following steps to upgrade TerrariumPI

Docker

• Stop TerrariumPI: docker compose down
• Update version number in docker-compose.yaml and run docker compose pull
• Start TerrariumPI: docker compose up -d

Or go to the upgrade steps on the documentation page

Manual

• Stop TerrariumPI: sudo service terrariumpi stop
• Update the code: git pull
• Rerun the installer: sudo ./install.sh
• Start TerrariumPI: sudo service terrariumpi start

Or go to the upgrade steps on the documentation page

Full Changelog: 4.11.0...4.11.1