Docs / Data & Backup

Data & backup

Everything Riverforge keeps — your chats, your memory, your settings — lives in one place on your own disk. This page shows you where, how to back it up, and how to move it to another drive or machine.

Where your data lives

Riverforge stores everything under a single data folder. By default that’s:

%APPDATA%\Riverforge

You chose this location (or accepted the default) during install. It holds your stored chats, your brain / project / research memory, your tool settings and custom tools, and the app’s logs. The quickest way to see it is the tray’s Open Data Folder button.

Your data folder is separate from where Ollama keeps its models. Models can be many gigabytes and live wherever you pointed Ollama during setup; backing up your data folder does not need to include them — you can always re-pull a model.

Backing up

To keep a full backup, close the tray and Memory Visualizer, then copy the whole data folder somewhere safe. Restoring is just copying it back. That single folder preserves:

Your settings file (model choices, data-folder location, approval timeout) lives alongside it as settings.json in %APPDATA%\Riverforge — copy that too for a complete backup.

Just want your chats and memory on a schedule? Point your normal backup tool (File History, OneDrive, a sync job) at the data folder while Riverforge is closed. Because everything is in one folder, there’s nothing else to track.

Moving to another drive

The tray handles this for you — no file juggling required.

  1. Open the tray and click Relocate Data Folder.
  2. Pick the new location. Riverforge moves your data there and switches to it.
  3. That’s it — your chats, memory and settings come with you.

If you prefer the command line, the packaged runner does the same:

PS> RiverforgeRunner.exe set-data-root "D:\RiverforgeData"

Restart Riverforge afterwards so the new location is used.

Transferring memory between machines

If you only want to carry your memory to another PC — not the whole install — export it rather than copying raw files. From the Memory Visualizer you can browse and manage memory, and the local server provides an export you can import on the other machine. This keeps the transfer clean and portable across versions.

Uninstalling keeps your data

Uninstalling Riverforge removes the program, but leaves your data folder and your models in place. Reinstalling and pointing at the same data folder brings everything back. If you truly want a clean slate, delete the data folder by hand after uninstalling.