Registry / auth-security / fusionauth-cli

fusionauth-cli

library1.2.4jsnpmunverified

@fusionauth/cli (v1.2.4) is a command-line tool for interacting with FusionAuth, an OIDC/OAuth authentication server. It enables downloading, uploading, and managing email templates, lambdas, and themes. This fork specifically fixes compatibility with Node.js 22, as the original package broke under that version. It is written in TypeScript and distributed as an npm package. Maintenance appears minimal (rare releases). Differentiators include watch functionality for live theme/email updates and environment variable support for API key and host.

auth-security devops

npm install fusionauth-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · FUSIONAUTH-CLI

fusionauth-cli

auth-securityjavascriptv1.2.4

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ npx @fusionauth/cli

✗ npm i @fusionauth/cli && node node_modules/@fusionauth/cli/bin/index.js

This is a CLI tool, not a library. Use npx to run directly.

global command

✓ npm i -g @fusionauth/cli && fusionauth --help

✗ npm i @fusionauth/cli && fusionauth --help

Global install is required to use the 'fusionauth' command without npx, but is discouraged due to potential conflicts.

Shows how to set environment variables and download all email templates using npx.

export FUSIONAUTH_HOST='http://localhost:9011' export FUSIONAUTH_API_KEY='your-api-key' npm i @fusionauth/cli npx fusionauth email:download -t all

fusionauth --version

Debug

Known issues

breakingNode.js versions below 19 not supported

fix

Update Node.js to v19 or later (tested on 19 and 22).

affects: <1.0.0?

gotchaGlobal install can cause conflicts with other global packages

fix

Use npx @fusionauth/cli instead of global install.

affects: all

deprecatedSome commands may be renamed or removed in future versions

fix

Check the documentation for the latest command list.

affects: all

gotchaEnvironment variables FUSIONAUTH_HOST and FUSIONAUTH_API_KEY must be set or passed via -h and -k flags

fix

Set the environment variables before running commands.

affects: all

gotchaForked from original FusionAuth CLI; may diverge in features

fix

Use the original FusionAuth CLI if you need the official version; this fork only fixes Node 22 compatibility.

affects: all

Errors

Common errors & fixes

Error: Cannot find module '@oclif/core'

Missing dependencies due to npm install issues or incorrect Node version.

fix

Run 'npm install' in the project directory or use npx to auto-install.

Error: Failed to authenticate: API key is missing

FUSIONAUTH_API_KEY environment variable not set or -k flag not provided.

fix

Set FUSIONAUTH_API_KEY environment variable or use -k option.

Error: Connection refused to http://localhost:9011

FusionAuth server is not running on the specified host/port.

fix

Ensure FusionAuth is running and FUSIONAUTH_HOST is correctly set.

Upgrade

Version history

1.2.4latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

14 hits · last 30 days

node

Resources

githubhttps://github.com/FusionAuth/fusionauth-node-cli ↗

packagehttps://www.npmjs.com/package/fusionauth-cli ↗

homepagehttps://fusionauth.io ↗