Common problems

The message box is disabled or says "No enabled provider models"#

OctoPress needs a connected provider with at least one enabled model.

1. Go to Settings → Providers and connect a provider. See Connect a provider.
2. Open its Models tab, switch on at least one model and click Save models.
3. Reload the chat.

The box is also disabled while a message is sending, while an approval or question is waiting, and until an agent, provider and model are selected.

Settings or Chats open the setup screen#

Setup has not been completed. Finish it (connect a provider, enable a model, click Start using OctoPress). See Install and set up.

The image button is greyed out#

Hover it to read the reason. Usually the selected model cannot read images, four images are already attached, or the chat is busy. See Images in chat.

Long answers stop halfway#

Symptoms: a run stays on Running, stops partway, or fails with a timeout.

OctoPress continues long runs by making requests to your own site and relying on WordPress cron. Check:

• Loopback requests work. Your host or a security plugin must allow the site to call itself. Firewalls and "basic auth" protection on staging sites often block this.
• WP-Cron runs. If DISABLE_WP_CRON is set, add a real server cron job that calls wp-cron.php every minute.
• PHP time limit. Tools → Site Health shows a warning "PHP stops requests too early for long OctoPress responses" when the limit is too low. Ask your host to raise max_execution_time.
• Pro: switch to the Shell driver if your host allows it. See Runtime.
• Use Retry after fixing the cause.

A tool or agent is missing#

A tool is available only when all of these are true: its extension is enabled, the tool is switched on, your role meets the minimum role, the agent allows it, and the provider supports it. Check, in order:

1. Settings → Extensions: is the extension Enabled and not Unavailable?
2. Settings → Tools: is the tool switched on, and is the Minimum role low enough?
3. Settings → Agents → Tools: is it ticked for the agent you are using?
4. For hosted web access and image generation: are you on a ChatGPT Login or OpenAI API Key provider?
5. For Pro tools: is your licence Active? See License.

See Tool access and roles.

An approval window will not go away#

Approval, question, plan and handoff windows are required decisions and cannot be dismissed. Decide, or click Stop in the chat to cancel the run.

"Models were refreshed recently"#

Models can be refreshed once every 30 seconds per provider. Wait a moment and try again.

The ChatGPT or Grok sign-in code expired#

Click Connect ChatGPT or Connect Grok again to get a new code, then finish sign-in before it expires.

An answer failed with a provider error#

A red message shows what the provider said, for example an invalid key, no credit or a rate limit. Fix the cause (check the key in Settings → Providers, your billing, or try another model) and click Retry.

I can't find an old chat#

The chat list shows your 50 most recent chats. Open an older chat from a bookmarked address (…page=octopress&chat=<id>). Archived chats are hidden from the list. Use projects to keep important chats within reach.

A WooCommerce or SEO tool is unavailable#

• WooCommerce: WooCommerce must be active and loaded; no Abilities API support is required. Catalog, coupon, customer and review tools additionally require the licensed Pro WooCommerce Store feature.
• SEO Content (Pro): Yoast SEO or Rank Math must be active.

Settings → Extensions shows the reason under Unavailable.

Pro features stopped working#

Open Settings → License. If the status is Expired, activate your key again. If it shows Grace period, fix the connection problem shown on the card and click Refresh status. See License.

A schedule did not run#

• The Next run date is in the past: WordPress cron is not running. Set up a real cron job.
• The page shows "Scheduled PHP execution is unavailable.": fix the PHP path in Settings → Runtime.
• The schedule is Paused or Failed: fix the cause and click Resume.

See Schedules.