Update Feluda — How to Update on Windows, Linux, and macOS

Before You Update

Updating Feluda is straightforward on every platform. Here is what you need to know before you begin:

Your data is always safe. Flows, journals, Genes (add-on capabilities), settings, and secrets are stored in your user profile — completely separate from the application files. Updates never overwrite or delete your personal data.

Close Feluda if it is currently running. This prevents file-lock issues during the update.
Visit the Feluda download page and download the latest version for your operating system.
Follow the platform-specific steps below to complete the update.

Update Feluda on Windows

🏳️ Windows Installer (Recommended)

Download the latest Windows installer from the download page.
Double-click the installer. It detects the previous installation and upgrades it in place — no need to uninstall first.
Follow the on-screen prompts. The process takes about a minute.
Launch Feluda from your desktop shortcut or Start Menu. Your flows, settings, and secrets are exactly where you left them.

📦 Windows Portable Executable

Download the latest portable executable from the download page.
Replace the old executable file with the new one in the same folder.
Run the new file. All your data is stored in %APPDATA%\Feluda\ and remains untouched.

Windows SmartScreen may show a warning after an update because the file signature is new. Click "More info" then "Run anyway" to proceed. This is normal for newly released versions.

Need the full setup walkthrough? See the Windows installation guide.

Update Feluda on Linux

The update process depends on which package format you are using. In every case, your user data in ~/.config/Feluda/ is preserved automatically.

📦 AppImage

Download the latest AppImage from the download page.
Replace the old AppImage file with the new one (or save it alongside and delete the old one).
Make sure the new file is executable:
chmod +x Feluda*.AppImage
Run the new AppImage. That's it — you are on the latest version.

📦 .deb Package (Debian / Ubuntu)

Download the latest .deb package from the download page, then run:

sudo apt install ./feluda*.deb

APT will detect the existing installation and upgrade it in place.

📦 .rpm Package (Fedora / RHEL / openSUSE)

Download the latest .rpm package from the download page, then run:

# Fedora / RHEL
sudo dnf upgrade ./feluda*.rpm

# openSUSE
sudo zypper update ./feluda*.rpm

📦 Standalone Binary

Download the latest binary from the download page.
Make it executable and replace the old binary:
chmod +x feluda
sudo mv feluda /usr/local/bin/

Need the full setup walkthrough? See the Linux installation guide.

Update Feluda on macOS

🍎 macOS

Download the latest macOS binary for your architecture (Apple Silicon, Intel, or universal) from the download page.
Make it executable and replace the old binary:
chmod +x Feluda-darwin*
mv Feluda-darwin* /usr/local/bin/feluda

Adjust the destination path to wherever you placed the original binary.
Launch Feluda. Your flows, settings, and secrets in ~/Library/Application Support/Feluda/ are exactly where you left them.

macOS Gatekeeper may show a warning after updating because the file signature is new. Open System Settings → Privacy & Security and click "Open Anyway", or run this command once in Terminal (replacing the path with the actual location of your binary):

xattr -c /usr/local/bin/feluda

Need the full setup walkthrough? See the macOS installation guide.

What Is Preserved During an Update

Feluda keeps your application files and your personal data in separate locations. An update only replaces the application files. Here is exactly what stays safe:

Data	Preserved?	Location
AI flows and workflows	Yes	User data folder
Journal entries	Yes	User data folder
Installed Genes	Yes	User data folder
App settings and preferences	Yes	User data folder
Secrets and API keys	Yes	OS keyring / credential store
Account link (Synchronize)	Yes	User data folder

Where is my user data folder?
Windows: %APPDATA%\Feluda\
Linux: ~/.config/Feluda/ (or $XDG_CONFIG_HOME/Feluda/)
macOS: ~/Library/Application Support/Feluda/

Troubleshooting

Feluda won't start after updating

Make sure you fully closed the previous version before replacing the files. On Windows, check the system tray for a running instance. On Linux and macOS, you can verify with ps aux | grep -i feluda and terminate any lingering process. Then try launching again.

My settings or flows are missing after the update

Updates never modify your user data folder. If something looks different, the new version may have changed the interface layout — your data is still there. Open the Studio to verify your flows are listed. If you moved your data folder manually, make sure the application is pointing to the correct location in Settings.

SmartScreen or Gatekeeper warning after updating

Each new release may trigger a security prompt from your operating system because the file is freshly downloaded. On Windows, click "More info" → "Run anyway". On macOS, open System Settings → Privacy & Security → "Open Anyway", or run xattr -cr /Applications/Feluda.app in Terminal.

How do I know which version I am running?

Your current version number is displayed in the bottom-left corner of the initial page in Feluda. You can click the version number to check whether an update is available — Feluda will redirect you to the download page if a newer version exists.

Can I skip versions when updating?

Yes. You can always jump directly to the latest version regardless of which version you currently have installed. There is no need to install intermediate releases.

How to Update Feluda