After installing OpenShrooly firmware using either the web installer or manual installation, you’ll need to configure your device for network access and initial setup.

WiFi Configuration

First Boot - Captive Portal

  1. Power on your device after firmware installation
  2. Look for WiFi network named OpenShrooly-Setup or similar
  3. Connect to this network from your phone or computer
  4. Open a web browser - you should be automatically redirected to the setup page
  5. Note the MAC address displayed at the top of the captive portal page (e.g., 040d98)
  6. Enter your WiFi credentials:
    • Select your home WiFi network from the list
    • Enter your WiFi password
    • Click “Save” or “Connect”

Device Connection

After successful WiFi configuration, your device will:

  • Disconnect from the setup network
  • Connect to your home WiFi
  • Restart and be available on your local network

Accessing Your Device

Local Web Interface

Once connected to WiFi, you can access your OpenShrooly device using:

  • Format: http://openshrooly-[MAC].local/
  • Example: http://openshrooly-040d98.local/
  • Where to find MAC: The last 6 characters from the captive portal page

Option 2: Router’s Device List

  1. Check your router’s admin interface
  2. Look for device named “OpenShrooly” or similar
  3. Note the assigned IP address (e.g., 192.168.1.100)
  4. Access via: http://[IP-ADDRESS]/

Option 3: Network Scanning

If the above methods don’t work:

# On Linux/Mac
nmap -sn 192.168.1.0/24 | grep -A 2 "OpenShrooly"

# On Windows (using Advanced IP Scanner or similar tools)

Initial Configuration

Once you can access the web interface:

1. Device Information

  • Verify firmware version
  • Check WiFi connection status
  • Note device MAC address and IP

2. Basic Settings

  • Set device name (optional)
  • Configure timezone (currently uses UTC)
  • Set up any basic preferences

3. Cultivation Setup

Proceed to Cultivation Setup to configure:

  • Mushroom species settings
  • Air exchange parameters
  • Humidity control
  • Lighting schedule
  • Environmental monitoring

Troubleshooting Setup

Cannot Find Setup Network

  • Power cycle the device (unplug for 10 seconds)
  • Wait 1-2 minutes after power on for setup network to appear
  • Try factory reset if device was previously configured

Cannot Access Local Interface

  • Verify WiFi connection - check router’s connected devices
  • Try different browsers - some block .local domains
  • Use IP address instead of .local address
  • Check firewall settings on your computer

Forgot Device IP/MAC

  • Power cycle device to potentially trigger setup mode again
  • Check router’s DHCP client list
  • Use network scanning tools

Next Steps

After successful setup:

  1. Configure Cultivation Settings - Set up your growing parameters
  2. Home Assistant Integration (optional) - For advanced monitoring
  3. Mushroom Settings Guide - Species-specific configurations

Security Note

  • The device creates an open WiFi network during initial setup
  • This network is only available briefly during first boot or after factory reset
  • Once configured, the device connects to your secure home network
  • Consider changing default passwords if any are set