Skip to content

FIREHOSE DOCUMENTATION

Activate Firehose

Read as Markdown

Activate Firehose on your computer so it can start agent sessions. Until you do, the dashboard shows an activation screen and nothing else works.

This page describes Firehose 1.2.0. Activation by emailed code started in Firehose 1.1.0; if your dashboard shows Activate this server instead of an email field, update Firehose with firehose update.

You need:

  • A Firehose installation from Install Firehose.
  • An email address you can read. Firehose sends a 6-digit code there. You can read the email on any device, such as your phone.

Activation needs a paid subscription, which belongs to that email address. If the address does not have one yet, you subscribe during activation. Billing starts the day you subscribe.

Everything happens on the dashboard at http://localhost:4801, except paying, which opens a checkout page in your browser.

  1. Open your dashboard. After a fresh install, it is already open and shows Activate Firehose.
  2. Type your email address under Email.
  3. Select Send code.
The Activate Firehose screen. It reads: This installation has not been activated yet. Enter your email address and we'll send you a 6-digit code. Below are an Email field showing you@example.com as a hint and the Send code button.
The dashboard before activation.

Firehose sends an email from Firehose <noreply@okthink.ai> with the subject Your Firehose code: followed by six digits. The dashboard says We sent a code to your address, and that it expires in 10 minutes.

  1. Type the six digits under Code.
  2. Select Verify.
The Activate Firehose screen reading: We sent a code to you@example.com. It expires in 10 minutes. The Code field holds 482915, followed by the Verify button and the Resend code and Use a different email links.
Entering the emailed code. The email address and code are examples; yours will differ.

If the email does not arrive, check your spam folder, then select Resend code. If you typed the wrong address, select Use a different email.

What happens next depends on your subscription.

Firehose unlocks right away. Continue to Check the result.

The dashboard says your address is verified and that activating Firehose needs a subscription; your card is charged today. Continue to the next step.

  1. Under Plan, choose Individual, billed monthly or Individual, billed yearly. The checkout page shows the price.
  2. Select Subscribe.
The Activate Firehose screen reading: you@example.com is verified. Activating Firehose needs a subscription; your card is charged today. Two plan choices, Individual, billed monthly (selected) and Individual, billed yearly, appear above the Subscribe button and a Use a different email link.
Choosing a plan. The email address is an example.

A checkout page opens in a new browser tab. The dashboard says Waiting for payment…. Pay on the checkout page; you have up to an hour.

The Activate Firehose screen reading: Checkout is open in your browser for you@example.com. Waiting for payment. Finish paying there; Firehose unlocks as soon as it goes through. Below are the Open checkout again and Choose a different plan links.
The dashboard while you pay. The email address is an example.

If you closed the checkout tab, select Open checkout again. To change plans, select Choose a different plan.

When the payment goes through, the checkout tab shows Payment received. You can close it and go back to the dashboard.

A page titled Payment received that reads: Go back to Firehose; it unlocks in a few seconds. You can close this page.
The page you see after paying.

If your address already has a subscription with a problem, usually a payment that did not go through, selecting Subscribe shows a message saying so. Select Manage billing, fix the payment, then select Subscribe again.

The plan screen with a red message: This account already has a subscription that needs attention, usually a payment that did not go through. Fix it in billing, then try again. Below it are a Manage billing link and the Subscribe button.
A subscription with a failed payment. The email address is an example.

Within a few seconds, the activation screen closes and Firehose opens with the Sessions sidebar. You do not need to reload. See Find your way around Firehose for what you are looking at.

Next, connect to Firehose and check that your agent is ready.

Open agents.okthink.ai/account and sign in with the email address you used to activate Firehose. You can select Continue with Google or have a sign-in link emailed to you. Select Manage billing to change your card, see invoices, switch plans, or cancel.

The account page titled Your Firehose account, showing Signed in as you@example.com, a note about the billing portal, a Manage billing button, and a Sign out link.
The account page. The email address is an example.

You do not need to reactivate after time away. Firehose renews its license on its own, including right after the computer starts.

The dashboard shows Reactivate Firehose only when a renewal fails:

  • Your subscription stopped, for example it was canceled or a payment failed. The screen names the reason. Fix it at agents.okthink.ai/account, and Firehose unlocks on its own at its next check, within about an hour.
  • Firehose could not reach the license service for 14 days while it kept running. Reconnect the computer to the internet, and Firehose unlocks at its next check.

To unlock right away instead of waiting, enter your email address on the Reactivate Firehose screen and repeat the steps above.

The Reactivate Firehose screen reading: This installation is locked: subscription is canceled. Enter your email address and we'll send you a 6-digit code. Below are the Email field and the Send code button.
A locked installation, with the reason the license service gave.
What you seeWhat to do
The email does not arriveCheck your spam folder, then select Resend code. Check that the address shown after We sent a code to is right; if not, select Use a different email.
That code isn’t right. and the attempts leftCheck the digits in the newest email and try again. Each code allows five tries.
That code has expired. or Too many wrong codes.Select Resend code for a new code. Codes last 10 minutes.
Too many codes were requested.Wait a few minutes, then try again. Firehose sends at most five codes an hour to one address.
The activation timed out before payment finished.More than an hour passed before payment went through. Enter your email address again; you get a new code.
Firehose could not reach its license service.Check that the computer is online, then try again.
The dashboard keeps waiting after the checkout page said Payment receivedCheck that the computer is online, then wait a minute. Firehose checks for the payment every few seconds.
License agreement instead of Activate FirehoseRead the agreement, also available as the published end-user license agreement, and select I accept. This appears if the agreement was not accepted during installation.
The License agreement screen reading Read and accept the agreement to use Firehose on this machine, with the agreement in a scrolling box and an I accept button.
The license agreement screen. The agreement text is shortened here; read the full agreement on the screen or at the link above.