NF nifi-flow-upgrade-advisor NiFi migration tooling for teams that want clarity first

Migrate Deliberately

Apache NiFi flow upgrade tool for safer migrations.

nifi-flow-upgrade-advisor is a desktop-first Apache NiFi upgrade tool with a CLI engine underneath for automation. It helps platform teams and flow owners answer one practical question: is this flow safe to move to the target NiFi version?

View on GitHub Desktop quick guide
Offline-first Deterministic rewrites only NiFi Registry and Git-friendly

Desktop First

Use the app first. Keep the CLI for automation.

The desktop app is now the default way to use the product. It scans a workspace, detects likely flows, guides the upgrade path, and explains the result before you ever need to look at raw command output.

Desktop workspace and flow selection screenshot

Start from the workspace

Pick a flow, confirm source and target versions, and let the app load the built-in upgrade coverage for you.

Desktop results and rewrite preview screenshot

See what to do next

Blocked, review, safe fixes, and info are separated clearly, with rewrite previews and next-action buttons.

Read the desktop guide

Start Here

Three simple ways to get value from the tool.

Most teams want one of three things first: a quick upgrade answer, a safe rewrite, or confidence that the target runtime is ready.

Use the desktop app Scan a workspace, pick a flow, and follow the app-first guided workflow before you think about CLI flags. Check an upgrade path Start with analyze to see blockers, assisted rewrites, manual changes, and safe rewrite candidates before you touch the flow. Apply rewrites Use rewrite when you want the tool to handle the deterministic part, scaffold reviewable changes, and leave risky migration work visible. Validate the target Check target version, extensions, and import readiness before rollout. Plan a 1.x to 2.x move Use the migration guide when you are crossing the major-version boundary and need bridge-upgrade awareness.
See example outcomes

Try it quickly

Start with three demos, then go deeper with a full example catalog.

Blocked path

Asana on NiFi 2.7 to 2.8

The demo shows how the tool reports removed components and blocks the upgrade instead of performing a risky silent conversion.

./demo/asana-2.7-to-2.8.sh
View script Demo guide
Auto-fix path

Base64EncodeContent on 1.27 to 2.0

The demo shows a safe deterministic rewrite where the rule pack explicitly allows a mechanical component replacement.

./demo/base64-1.27-to-2.0.sh
View script Demo guide
Assisted rewrite

GetHTTP on 1.27 to 2.0

The demo shows the middle case: Apache documents the migration, and the tool scaffolds the target InvokeHTTP shape while still leaving final review visible to a human.

./demo/get-http-1.27-to-2.0.sh
View script Demo guide
Browse all examples

Docs

Everything else lives in the docs, not on the homepage.

Start with the desktop guide or examples first. The CLI reference and deeper migration notes are there when you need them.

Desktop guide Use the app-first flow for everyday work, then drop to CLI only when you need automation. CLI reference Use the CLI when you need CI, GitOps, or explicit command-level control. Rule packs Understand how upgrade rules are authored, including private packs for custom processors and services. Troubleshooting Handle blocked findings, target mismatches, and missing secret values faster.