Skip to main content

​
Overview

The FalkorDB Browser UI is the visual query tool for the local FalkorDB graph database — the FalkorDB equivalent of the Neo4j Browser at http://localhost:7474. It is hosted by the devcontainer and lets you run ad-hoc Cypher queries against the local graph. BETA-272 introduced FalkorDB as an alternate graph backend via the graph abstraction layer (see Graph backend). Both backends ship in the devcontainer for local development; production deployments often default to Neo4j and treat FalkorDB as bring-your-own. The browser is exposed at: 
http://localhost:3005

​
Connection settings

Open http://localhost:3005 in your browser, then enter the following on the connection screen:
FieldValue
Hostlocalhost
Port6379
Usernamedefault
Passwordexperio_falkor_dev_password
TLS Secured Connectionunchecked
Both the host port mapping and the password are defined in .devcontainer/docker-compose.yml:
falkordb:
  image: falkordb/falkordb:latest
  ports:
    - 6380:6379  # Redis protocol (host:container)
    - 3005:3000  # Browser UI (host:container)
  environment:
    - FALKORDB_ARGS=--requirepass experio_falkor_dev_password

​
Important: use port 6379, not 6380

When filling in the browser connection form, use port 6379, not 6380. This is the most common cause of “connection refused” when wiring up the browser for the first time. The reason: the browser process runs inside the FalkorDB container, so it connects to the Redis protocol port that is internal to the container — which is 6379. The host port mapping 6380:6379 in .devcontainer/docker-compose.yml exists only so processes running on the host machine (e.g. Django on macOS) can reach FalkorDB. The browser is already inside the container network, so it bypasses the host port mapping entirely. 
                            ┌─────────────────────────────────┐
                            │  FalkorDB container             │
                            │                                 │
  Host (macOS/Linux)        │   ┌─────────────────────────┐   │
  ──────────────────  6380  │   │  Redis protocol :6379   │   │
   redis-cli, Django ──────►│──►│  (internal)             │   │
                            │   └─────────────────────────┘   │
                            │              ▲                  │
                            │              │                  │
                            │   ┌─────────────────────────┐   │
   Browser UI :3005   ──────│──►│  Browser :3000          │   │
   ──────────────────  3005 │   │  (uses host=localhost   │   │
                            │   │  port=6379 inside)      │   │
                            │   └─────────────────────────┘   │
                            └─────────────────────────────────┘
In short:
CallerHostPort
FalkorDB Browser (in container)localhost6379
redis-cli / Django (on host)localhost6380

​
Verifying the connection from the host

To confirm FalkorDB is up and accepting the password before you launch the browser, run from the host: 
redis-cli -h localhost -p 6380 -a experio_falkor_dev_password PING
Expected output: 
PONG
You can also confirm the graph database engine is loaded: 
redis-cli -h localhost -p 6380 -a experio_falkor_dev_password GRAPH.LIST

​
Switching the active graph provider

Experio chooses between Neo4j and FalkorDB at runtime via System Settings. To change the active provider, navigate to: Admin → Settings → System Settings → Database & Storage → Graph Database There you can toggle between providers and update connection credentials. See System Settings for the full list of FALKOR_* and NEO4J_* keys.
After pulling graph-backend or scale-to-zero changes onto a previously-seeded database, run cd server && pipenv run python manage.py seed_config --force once to refresh connection defaults (cluster FALKOR_URI is redis://falkordb:6379; devcontainer host access remains redis://localhost:6380). On Omnistrate, also run seed_autoscaling_config if neo4j / falkordb ServiceConfiguration rows are missing.

​
When to use FalkorDB Browser vs System Settings

Use caseTool
Ad-hoc Cypher exploration of the graphFalkorDB Browser (http://localhost:3005)
Inspecting nodes, relationships, indexes, vector indexesFalkorDB Browser
Changing connection credentials (host, port, password, user)System Settings
Switching the active graph backend (Neo4j ↔ FalkorDB)System Settings
The browser is read/write — you can run MATCH, CREATE, MERGE, and DROP queries — but credentials and provider selection live in System Settings.

​
Troubleshooting

If the browser does not load or the connection fails:
  • Browser does not load at http://localhost:3005
    • Confirm the devcontainer is running: docker compose -f .devcontainer/docker-compose.yml ps falkordb should show running (healthy).
    • Confirm port 3005 is not already in use on the host: lsof -i :3005.
  • Connection refused / “ETIMEDOUT” from the browser form
    • Verify you used port 6379, not 6380. See the “Important” callout above.
  • Authentication failed
    • The password must match the FALKORDB_ARGS=--requirepass … value in .devcontainer/docker-compose.yml. If you changed it locally, restart the FalkorDB service: docker compose -f .devcontainer/docker-compose.yml restart falkordb.
  • Browser loads but redis-cli fails from the host
    • From the host you must use port 6380, not 6379. The host’s 6379 is mapped to the separate redis (Redis Stack) service.
  • Connection drops or graph is empty after a restart
    • The graph is persisted to the falkordb-data Docker volume. If you ran docker compose down -v, the volume was removed; reseed the graph through the normal ingestion flow.