Desktop Installation Guide

Install FamilyFunds on Your Desktop

Run FamilyFunds entirely on your own device — no internet required after setup. Your financial data never leaves your machine.

Part 1 — Web platform

Download your installer & setup config

1

Sign in to the FamilyFunds web platform

Open your browser and navigate to the platform. Sign in with your Premium account credentials.

https://familyfunds.ca Sign In
2

Open your Profile page

Click the Profile button in the top-right navigation bar after signing in.

Top-right navigation Profile
3

Find the "Download Desktop App" section

Scroll down to the Premium section on the Profile page. You will see a dark panel titled Download Desktop App — this panel is visible only to Premium users.

Don't see it? Your account may not have Premium access yet. Contact support at info@rcslogic.com.
4

Download the installer for your operating system

Inside the "Download Desktop App" panel, click the button that matches your OS:

Windows (.exe) or macOS (.dmg) or Linux (.AppImage)

Save the file to a folder you can find easily — your Downloads folder works well.

5

Download your personal Setup Config

Still on the Profile page, click the Download Setup Config button. This downloads a file called setup_config.json.

Download Setup Config setup_config.json
Security: This file contains your account credentials and a snapshot of your cloud data. It is automatically deleted after first use — never share it with anyone.

Place setup_config.json in the same folder as the installer you downloaded in Step 4.


Part 2 — Installation

Install & launch on your computer

6

Run the Windows installer

Double-click FamilyFunds_Setup_Windows.exe in your Downloads folder.

If Windows SmartScreen shows a blue warning screen, click More info then Run anyway. This warning appears because the app hasn't yet built a widespread reputation with Microsoft — it is completely safe.

No admin password needed. The installer places the app in your personal %LOCALAPPDATA%\Programs\FamilyFunds folder, not in Program Files.
7

Follow the setup wizard

Click Next through the wizard. On the final page, leave Launch FamilyFunds checked and click Finish.

The wizard creates a Desktop shortcut and a Start Menu entry for future launches.

8

First launch — your data is imported automatically

FamilyFunds opens your default browser at http://127.0.0.1:8765. It reads setup_config.json on first run, creates your account, restores your data snapshot, then deletes the config file for security.

A small tray icon appears in the Windows system tray (bottom-right corner of taskbar). The server keeps running after you close the browser tab — right-click the tray icon to reopen or quit.

9

Future launches

Use the Desktop shortcut, the Start Menu, or right-click the system tray icon and choose Open FamilyFunds.

6

Open the DMG file

Double-click FamilyFunds_Mac.dmg in your Downloads folder. A Finder window opens showing the FamilyFunds app icon and an Applications folder shortcut.

7

Drag FamilyFunds to Applications

Drag the FamilyFunds icon onto the Applications folder shortcut in the DMG window. Wait for the copy to finish, then eject the DMG (drag it to Trash or press ⌘+E).

Copy setup_config.json into the same Applications folder, next to FamilyFunds.app.

8

Allow the app (first time only)

macOS Gatekeeper blocks apps not distributed via the App Store on first open. To bypass this:

1. Open Finder → Applications and locate FamilyFunds.

2. Right-click (Control-click) → Open.

3. Click Open in the confirmation dialog.

Alternatively: System Settings → Privacy & Security → scroll down and click Open Anyway next to the FamilyFunds warning. You only need to do this once.
9

First launch — your data is imported automatically

FamilyFunds opens your browser at http://127.0.0.1:8765. Your account and data are set up from the config file, which is then deleted. A menu-bar icon appears in the top-right of your screen — click it to reopen the app or quit.

10

Future launches

Open Launchpad, or press ⌘+Space and type FamilyFunds. Or click the menu-bar icon.

6

Make the AppImage executable

Open a terminal and run:

chmod +x ~/Downloads/FamilyFunds_Linux.AppImage

Or: right-click the file in your file manager → Properties → Permissions → enable Allow executing file as program.

7

Place setup_config.json in the same folder

Make sure both files are in the same directory before launching:

~/Downloads/
├── FamilyFunds_Linux.AppImage
└── setup_config.json
8

Run the AppImage

Double-click the AppImage in your file manager, or run from terminal:

./FamilyFunds_Linux.AppImage
Missing libfuse2? If the app fails to start, install FUSE:
Ubuntu/Debian: sudo apt install libfuse2
Fedora: sudo dnf install fuse-libs
9

First launch — your data is imported automatically

FamilyFunds opens your browser at http://127.0.0.1:8765. Your account and data are created from the config file, which is then deleted for security. A system tray icon keeps the server running in the background.


Part 3 — Optional

Set up AI API keys

AI features (chat, analytics, portfolio insights) require your own API key. Core features like Portfolio, Budget, Planning, and Bookkeeping work without any key.

A

Open Desktop Settings

With the app running, go to:

http://127.0.0.1:8765/desktop/settings

Or click Desktop Settings in the Download Desktop App card on your Profile page.

B

Get a free API key

Claude (Anthropic) — recommended:
Go to console.anthropic.comAPI KeysCreate Key. Free tier available.

Gemini (Google):
Go to aistudio.google.com/apikeyCreate API key. Free tier available.

C

Paste, test, and save

In Desktop Settings, paste your key into the appropriate field, click Test to verify it works, then click Save Settings. Your key is stored locally on your device only.


Help & troubleshooting

Frequently Asked Questions

Where is my data stored on disk?

Windows: %APPDATA%\FamilyFunds\ (typically C:\Users\YourName\AppData\Roaming\FamilyFunds\)

macOS: ~/Library/Application Support/FamilyFunds/

Linux: ~/.local/share/FamilyFunds/

All your financial data, session files, and settings live in this folder. You can back it up at any time by copying the folder.

Can I use the desktop app offline?

Yes — all core features work without internet. An internet connection is only needed for:

• Live stock price lookups in the Portfolio page

• AI chat/analytics if you use an external API key (Claude or Gemini)

How do I update the desktop app?

Download the new installer from the Download Desktop App section on your Profile page on the web platform. Run it over the existing installation (no need to uninstall first). Your data folder is not affected.

macOS says the app is from an unidentified developer

This is macOS Gatekeeper protecting against unsigned apps. FamilyFunds is safe — it is simply not yet in the Mac App Store. To open it once and permanently allow it:

1. In Finder, right-click (Control-click) FamilyFundsOpen

2. Click Open in the dialog

After doing this once, the app opens normally on every future launch.

The browser shows "This site can't be reached" at 127.0.0.1:8765

The local server may still be starting up. Wait 5–10 seconds and refresh the tab.

If it persists:

• Check that another app isn't already using port 8765

• Quit and relaunch FamilyFunds from the tray icon or Start Menu

• Check your antivirus or firewall — add an exception for FamilyFunds.exe (Windows) or FamilyFunds.app (macOS)

Can I run the desktop app and the web version at the same time?

Yes, but they use separate data stores. Changes made in one are not automatically reflected in the other. Use Import / Export to transfer data between them.

I lost my setup_config.json — how do I get a new one?

Sign in to the web platform, open your Profile page, and click Download Setup Config again. Each download generates a fresh config with the current snapshot of your data.

Note: if you have already completed first-run setup on the desktop, a new config download will not overwrite existing local data — only missing files are restored.

How do I uninstall?

Windows: Settings → Apps → search FamilyFunds → Uninstall. Your data folder in %APPDATA%\FamilyFunds is preserved and must be removed manually if desired.

macOS: Drag FamilyFunds.app from Applications to Trash. Data in ~/Library/Application Support/FamilyFunds must be removed manually.

Linux: Delete the AppImage file. Data in ~/.local/share/FamilyFunds must be removed manually.

How do I get support?

Email info@rcslogic.com with a description of your issue and your operating system. We typically respond within one business day.

🏠 Главная
Гость · English · Français · Русский