Documentation

MushroomOps Help Guide

Learn how to use every feature of the MushroomOps farm management app — from daily logging to AI-powered analytics.

Getting Started

Welcome to MushroomOps — a complete farm management tool for mushroom cultivation operations.

First-Time Setup

  1. Download the MushroomOps app from the Google Play Store or visit mushroomops.com on your browser.
  2. Sign up with your email and password. The first user automatically becomes the Farm Admin.
  3. Set up your Company Name and Crate Weight in Settings > Company Control.
  4. Add your Facilities (bunkers, tunnels, rooms, platforms, lagoons) in Settings > Facilities.
  5. Configure Phases for your compost, tunnel, and room workflows in Settings > Phases.
  6. Create your first Lot in Settings > Lots to start tracking a compost batch.
  7. Invite team members via Settings > Company Users or Team Management.
Tip: MushroomOps works offline. You can enter data even without internet — it will sync automatically when connectivity returns.

Dashboard All Roles

The Dashboard gives you a real-time overview of your farm's status at a glance.

Daily Logs Overview All Roles

The Logs section is the core of MushroomOps. Workers and managers use these screens to record daily operational data. All log types are accessible from the sidebar under the Logs section.

Each log form supports photo attachments — tap the camera icon to capture evidence directly from your device.

Compost Mixing Logs

Record the ingredients and proportions used when preparing a new compost batch.

Compost Status Logs

Track the ongoing condition of compost batches as they progress through phases.

Casing Prep Logs

Log the preparation of casing material before it's applied to compost beds.

Room Status Logs

Monitor environmental conditions in your growing rooms.

Harvest / Production Logs

Record daily mushroom harvests for each worker and room.

Quality Inspection

Grade mushroom batches using standardized quality metrics.

Daily Dispatch

Log outgoing shipments from the farm to buyers and markets.

Reports Admin / Manager

Reports provide aggregated views of your farm data. Access them from the Reports section in the sidebar.

Available Reports

Tip: Use the date range filter on each report to focus on specific periods. Reports can be exported as CSV from Settings > Import/Export.

AI Features Admin Only

MushroomOps includes optional AI-powered analysis to help you make better farm decisions.

AI Analyst

Generate comprehensive insights from your room and compost data. The AI analyzes environmental trends, disease patterns, and production metrics to provide actionable recommendations. Reports are available in English and Hindi.

Insights Inbox

Review AI-generated alerts and recommendations. The inbox collects analysis results so you can review them at your convenience.

Ask AI

Chat directly with the farm AI assistant. Ask questions about your operations, get advice on compost ratios, disease treatment, or environmental optimization.

AI Setup

  1. Go to Settings > AI to configure your AI provider.
  2. Choose a provider: Google Gemini, OpenAI, or Cloud Ollama (self-hosted).
  3. Enter your API key and endpoint URL as required.
  4. AI features will become active once the provider is configured.
Note: AI analysis sends your operational data (temperatures, CO₂ levels, disease observations, etc.) to the configured AI provider for processing. No personal data is included. You can disable AI features at any time by removing the API key.

Settings & Administration Admin Only

Most settings require Admin access. Workers can only access Appearance and Log Dropdowns.

Appearance

Switch between Light, Dark, or System theme. The setting is saved locally on your device.

Company Control

Edit your company name and set the standard crate weight used for harvest calculations.

Company Users

View all team members, promote users to Admin or Manager, or revoke access. Each user is tied to a role that controls what they can see and do.

Team Management

Quickly create new worker or manager accounts from within the app without them needing to sign up separately.

Facilities

Add, rename, or archive facilities. Facility types include: Bunker, Tunnel, Room, Platform, and Lagoon.

Phases

Define the production phases for each category (compost, tunnel, room). Phases determine the workflow progression of each lot.

Lot Linking

Manually adjust the active lot-to-facility association when automatic tracking needs correction.

Data Editor

Edit recent log entries directly within a 2-day window. Older records are locked to preserve data integrity.

Import / Export

Export your farm data as CSV or JSON files. Download attached images as a ZIP archive. Useful for backups and external analysis.

Log Dropdowns

Manage the dropdown values that appear in log forms: worker names, medicine names, disease types, and dispatch destinations.

Lots

Create new lots (compost batches) and review their current status, active phase, and facility location.

Offline Mode

MushroomOps is designed for farms with unreliable internet connectivity.

Tip: If you notice data not appearing for other users, check your internet connection and wait for the sync indicator to complete.

Roles & Permissions

MushroomOps uses role-based access control to ensure each team member sees only what they need.

Feature Admin Manager Worker
Dashboard
Enter Logs
View Reports
AI Features
Manage Facilities, Phases, Lots
Manage Users
Appearance & Log Dropdowns

Troubleshooting

Data not syncing

Check your internet connection. The app syncs automatically when connectivity is restored. If the issue persists, try closing and reopening the app.

Cannot see certain settings

Most settings require Admin role. Ask your Farm Admin to check your assigned role in Company Users.

Camera not working

Ensure you have granted camera permission to MushroomOps in your device settings. Go to your phone's Settings > Apps > MushroomOps > Permissions > Camera > Allow.

Forgot password

On the login screen, use the password reset option. A reset link will be sent to your registered email address.

App crashing or slow

Make sure you're running the latest version from the Play Store. Clear the app cache from your device settings if the problem continues.

Need more help?

Visit our Contact page and we'll get back to you as soon as possible.