---
title: Use the Interactive Flux REPL
description: Use the Flux REPL (Read–Eval–Print Loop) to execute Flux scripts and interact with InfluxDB and other data sources.
url: https://docs.influxdata.com/influxdb/v2/tools/flux-repl/
estimated_tokens: 500
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/tools/flux-repl/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.

#### API token hashing is enabled by default in InfluxDB OSS 2.9.0

Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.

For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).

Use the Flux REPL (Read–Eval–Print Loop) to execute Flux scripts and interact with InfluxDB and other data sources.[Build the REPL](#build-the-repl) from the Flux source code.

> [!Note]
> Flux REPL supports running Flux scripts against InfluxDB 1.8+.

## Build the REPL

To use the Flux REPL, build it from source using the [Flux repository](https://github.com/influxdata/flux/).
For instructions, see the [Flux repository README](https://github.com/influxdata/flux/#requirements).

## Use the REPL

* [Open a REPL session](#open-a-repl-session)
* [Query data from InfluxDB](#query-data-from-influxdb)
* [Multi-line entries](#multi-line-entries)
* [Exit the REPL](#exit-the-repl)

### Open a REPL session

To open a new REPL session, run:

```sh
./flux repl
```

### Query data from InfluxDB

To query data from InfluxDB (local or remote), provide the host, organization, and token parameters
to the [`from()` function](/flux/v0/stdlib/influxdata/influxdb/from/).

```js
from(
    bucket: "example-bucket",
    host: "http://localhost:8086",
    org: "example-org",
    token: "My5uP3rS3cRetT0k3n",
)
```

### Multi-line entries

Multi-line scripts like the example above work when pasted into the REPL.
Pasting newlines from the clipboard is allowed.
However, you cannot enter newline characters directly from the keyboard.

### Exit the REPL

Exit the REPL by pressing **Control + D**.

[flux](/influxdb/v2/tags/flux/)