# 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`.

```bash
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:

```bash
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:

```bash
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

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