---
title: "2.1 Requirements and Installation"
space: "Vuna Livestock"
url: "https://docs.navari.co.ke/livestock-management/1-getting-started/2-getting-started/2-1-requirements"
updated: "2026-10-24"
---

## **Software**

This repository targets Frappe v16 (`>=16.0.0-dev,<17.0.0`) and declares Python `>=3.14,<3.15`. Install compatible ERPNext and HRMS apps on the same site; the app declares both as required dependencies. Use the requirements of the release you actually deploy when maintaining another branch.

A self-hosted installation needs a working Bench environment, database, Redis, workers, and scheduler. This guide begins with an existing Bench and site; it does not describe operating-system installation.

## **Farm preparation**

Before recording transactions, prepare:

- Company, currency, chart of accounts, and appropriate stock difference accounts.
- Livestock houses and feed/produce stores as Company Warehouses.
- Livestock, feed, medicine, and produce Items with verified stock UOMs and conversions.
- Users, roles, and an active Employee for each Daily Farm Entry operator.
- Opening stock or receipt documents establishing actual animal and feed inventory.

Prepare verified hatch dates and breeder target tables if using performance profiles. Agree alert thresholds with farm management before enabling rules.



## **Production Setup**

### **Managed Hosting**

You can download the app from [Frappe Cloud](https://frappecloud.com/), a simple, user-friendly and sophisticated [open-source](https://github.com/frappe/press) platform to host Frappe applications with peace of mind.

It takes care of installation, setup, upgrades, monitoring, maintenance and support of your Frappe deployments. It is a fully featured developer platform with an ability to manage and control multiple Frappe deployments.



<picture>
  <img src="https://frappe.io/files/try-on-fc-black.png" alt="Try on Frappe Cloud" width="204" data-align="left">
</picture>

## **Development Setup**

### **Manual Installation**

Install compatible ERPNext and HRMS first. From the Bench directory, fetch the repository and install it on your site. Replace all placeholders, including the branch, with your deployment values.

```bash
bench get-app https://github.com/navariltd/livestock-management.git
bench --site YOUR_SITE install-app livestock_management
```