animal_management/INSTALL.md

Animal Management Installation Guide

This guide installs the animal_management module in a reusable way for any HumHub instance.

1. Requirements

• HumHub 1.14+
• Module directory access on the target instance
• Optional but recommended: rescue_foundation module

2. Clone into HumHub Modules Directory

The folder name must be exactly animal_management.

git clone https://gitea.kelinreij.duckdns.org/humhub-modules/animal-management.git \
  /var/www/localhost/htdocs/protected/modules/animal_management

If the folder already exists:

cd /var/www/localhost/htdocs/protected/modules/animal_management
git pull

3. Enable the Module

In HumHub UI:

1. Go to Administration -> Modules.
2. Enable Animal Management.
3. Enable it per space where needed.

4. Run Migrations

From the HumHub app host/container:

php /var/www/localhost/htdocs/protected/yii migrate/up \
  --include-module-migrations=1 --interactive=0

5. Verify

1. Open a space where the module is enabled.
2. Confirm Animals views load.
3. Confirm medical/progress/transfer flows render without errors.

Docker Example

docker exec humhub php /var/www/localhost/htdocs/protected/yii migrate/up \
  --include-module-migrations=1 --interactive=0