System Requirements

This guide outlines the requirements for running AgriOS, whether self-hosted or using a managed hosting provider.

Odoo Requirements

AgriOS is built on Odoo Community Edition. Ensure your environment meets the Odoo requirements:

  • Odoo Version: 18.0 (AgriOS 1.0.0)

  • Python: 3.10 or higher

  • PostgreSQL: 14 or higher

Hardware Requirements

Minimum (Development/Testing)

  • CPU: 2 cores

  • RAM: 4 GB

  • Storage: 20 GB SSD

Large Deployments

For deployments with thousands of farmers or high transaction volumes:

  • CPU: 8+ cores

  • RAM: 16+ GB

  • Storage: 100+ GB SSD with room for growth

  • Consider load balancing and database replication

Software Requirements

Operating System

  • Ubuntu 22.04 LTS or 24.04 LTS (recommended)

  • Debian 11 or 12

  • Other Linux distributions supported by Odoo

Database

  • PostgreSQL 14, 15, or 16

  • Properly configured for Odoo (see Odoo documentation)

Web Server (Optional)

For production deployments, a reverse proxy is recommended:

  • Nginx (recommended)

  • Apache with mod_proxy

Python Dependencies

AgriOS requires the standard Odoo Python dependencies plus:

  • geopy - For geolocation features

  • Additional dependencies listed in module requirements

Network Requirements

Ports

  • 8069: Odoo HTTP (default)

  • 8072: Odoo longpolling (for live updates)

  • 443: HTTPS (production)

  • 5432: PostgreSQL (internal only)

Outbound Connections

If using external integrations:

  • KoBoToolbox API: HTTPS to kf.kobotoolbox.org or your KoBo server

  • Email: SMTP server access

  • Cloudpepper API: If using Cloudpepper services

Browser Requirements

AgriOS web interface supports:

  • Chrome/Chromium: Version 90+

  • Firefox: Version 90+

  • Safari: Version 14+

  • Edge: Version 90+

JavaScript must be enabled.

Mobile Access

The AgriOS web interface is responsive and works on mobile browsers. For field data collection, KoBoToolbox mobile apps are recommended:

  • KoBoCollect (Android)

  • Enketo web forms (all platforms)

Managed Hosting

If using Cloudpepper or another managed hosting provider, they handle:

  • Server provisioning and maintenance

  • Database administration

  • Security updates

  • Backups

You only need to ensure you have:

  • Reliable internet connection

  • Compatible web browser

  • User accounts with appropriate permissions

See Cloudpepper Hosting for details on managed hosting.