Set option

The Set option action changes connection settings on your NETGEAR LTE modem, the same options that are otherwise available in the modem web interface. You can set the failover mode, the auto-connect mode, or both.

This is handy when you want to adjust how the modem manages its connection from an automation, for example to allow mobile data only while you are away from home.

Using this action from the user interface

If you prefer building automations and scripts visually, Home Assistant walks you through this action step by step. You pick what to target, tweak a few options, and save. No YAML knowledge required.

To set modem options from an automation or a script:

  1. Go to Settings > Automations & scenes.
  2. Open an existing automation or script, or select Create automation > Create new automation.
  3. If you’re setting up a new automation, add a trigger in the When section. Scripts don’t need a trigger. They run when something else calls them.
  4. In the Then do section, select Add action.
  5. From the search box, search for and select NETGEAR LTE: Set option.
  6. Set the Failover mode, the Auto-connect mode, or both. If you have more than one modem, also enter the Host.
  7. Select Save.

This action does not support targets. In the UI, you select the modem through the Host field instead of choosing an area, device, entity, or label. When you have only one modem configured, you can leave it empty.

Options in the UI

Host (Optional)

The modem to set options on. Optional when only one modem is configured.

Failover (Optional)

The failover mode: wire (wired connection only), mobile (mobile connection only), or auto (wired connection with failover to mobile).

Auto-connect (Optional)

The auto-connect mode: never, home (connect only when not roaming), or always.

You need to set at least one of Failover or Auto-connect.

Using this action in YAML

If you work directly in YAML, or you want to know exactly what Home Assistant does under the hood, this section has the technical reference. It lists the field names you use in YAML, their types, and which ones are required.

In YAML, refer to this action as netgear_lte.set_option. A basic example looks like this:

ActionActions are used in several places in Home Assistant. As part of a script or automation, actions define what is going to happen once a trigger is activated. In scripts, an action is called *sequence*. [Learn more]
action: netgear_lte.set_option
data:
  host: 192.168.5.1
  failover: auto
  autoconnect: home

This sets the failover and auto-connect modes on the modem.

Options in YAML

host string

The modem to set options on. Optional when only one modem is configured.

failover string

The failover mode. One of wire (wired connection only), mobile (mobile connection only), or auto (wired connection with failover to mobile).

autoconnect string

The auto-connect mode. One of never, home (connect only when not roaming), or always.

You need to set at least one of failover or autoconnect.

Try it yourself

Ready to test this? Open Developer tools > Actions, search for this action, fill in the fields, and select Perform action. You see what happens on your actual entitiesAn entity represents a sensor, actor, or function in Home Assistant. Entities are used to monitor physical properties or to control other entities. An entity is usually part of a device or a service. [Learn more] without writing a line of YAML.

More examples

Real scenarios where this action shows up in automations and scripts. Copy any example and adapt it to your setup.

Tip

You don’t need to edit YAML to use these examples. Copy a YAML snippet from this page, open the automation editor in Home Assistant, and press Ctrl+V (or Cmd+V on Mac). Home Assistant automatically converts the pasted YAML into the visual editor format, whether it’s a full automation, a single trigger, a condition, or an action.

Automation: set auto-connect mode when you leave home

When you leave home, set the modem to always connect.

  • Trigger: A presence sensor changes
  • Action: NETGEAR LTE: Set option
YAML example for changing auto-connect based on presence
AutomationAutomations in Home Assistant allow you to automatically respond to things that happen in and around your home. [Learn more]
alias: "Mobile data only while away"
triggers:
  - trigger: state
    entity_id: person.me
    to: not_home
actions:
  - action: netgear_lte.set_option
    data:
      host: 192.168.5.1
      autoconnect: always

Still stuck?

The Home Assistant community is quick to help: join Discord for real-time chat, post on the community forum with the action you’re calling and what you expected to happen, or share on our subreddit /r/homeassistant.

Tip

AI assistants like ChatGPT or Claude can also explain actions or suggest the right one when you describe what you want in plain language.

Related actions

These actions work well alongside this one:

  • Connect LTE: Asks the NETGEAR LTE modem to establish its LTE connection.

  • Disconnect LTE: Asks the NETGEAR LTE modem to close its LTE connection.

  • Delete SMS: Deletes messages from the NETGEAR LTE modem inbox.