Skip to main content

Troubleshooting

Updated

Use this guide to troubleshoot common Scaryfolio issues. Scaryfolio requires Ghostfolio 3.44.0 or newer.

Connection Issues

Connect Button is Disabled

  • Enter a Security Token.
  • For self-hosted servers, enter a server URL.

Authentication Failed

  1. Copy your Ghostfolio Security Token again.
  2. Remove extra spaces before or after the token.
  3. If the token has expired or changed, generate or copy a fresh token in Ghostfolio.
  4. For self-hosted servers, verify the URL and custom headers.

Restoring Connection or iCloud Error

  • Confirm the device uses the same Apple Account as your other Scaryfolio devices.
  • Confirm iCloud Keychain is enabled.
  • Unlock your devices after restarting them.
  • Open Scaryfolio Settings and choose Retry.
  • Update Scaryfolio on all devices if the app asks you to update.
  • Allow a few moments for iCloud to synchronize.

Do not use Disconnect to fix a temporary iCloud problem. Disconnect affects every Scaryfolio device using the same Apple Account.

Cannot Connect to Self-Hosted Server

  • Open the Ghostfolio URL in Safari on the same device.
  • Confirm the server is running and reachable from your network.
  • Check firewall, DNS, VPN, reverse proxy, and port settings.
  • If using HTTPS, use a valid HTTPS certificate.
  • If using Cloudflare Access, Authelia, Authentik, or another proxy, verify all custom headers.

Portfolio Not Available

  • Ghostfolio Cloud: Portfolio API data may require Ghostfolio Premium.
  • Self-hosted: Ensure your instance has portfolio data and that Scaryfolio and Ghostfolio are up to date.
  • Try another time range such as Max.
  • Refresh the Portfolio screen.

Allocations Are Unavailable

  • Portfolio Allocations requires Scaryfolio Pro.
  • Confirm Scaryfolio is connected to Ghostfolio.
  • Confirm your Ghostfolio server is version 3.44.0 or newer.
  • Refresh the Allocations screen from the Portfolio toolbar.
  • Check whether your Ghostfolio account or plan provides portfolio details.
  • Review holdings for missing sector, country, currency, or other metadata.

A breakdown can show Unknown or No Data when Ghostfolio does not provide enough metadata. ETF Provider labels are inferred from available ETF information and may be approximate. Zen Mode can also hide absolute values while leaving percentages visible.

Data & Display Issues

Data Not Updating

  • Manually refresh the affected screen.
  • Close and reopen the affected screen.
  • Check the same data in Ghostfolio's web interface.
  • Reconnect with the Security Token if authentication fails. Use Disconnect only when you intend to disconnect every Scaryfolio device on the same Apple Account.

Watchlist or Markets Not Updating

Watchlist and Markets data refreshes when opened. Use manual refresh when you need the latest data.

Incorrect Currency

Scaryfolio reads your base currency from Ghostfolio user settings. Verify your Ghostfolio base currency and reconnect if it changed recently.

Base Currency or Zen Mode Does Not Save

  • Open Settings > Ghostfolio User Settings and try saving again.
  • Check that your Ghostfolio server is reachable.
  • Reconnect if authentication may have expired.
  • For self-hosted instances, verify that your Ghostfolio version supports updating user settings through the API.

Missing Accounts

  • Check whether the account is excluded from analysis.
  • With Pro, enable Settings > View Options > Show Excluded Accounts.
  • Confirm the account exists in Ghostfolio.

Unexpected Performance Percentages

Scaryfolio can show investment-based or period-based returns. With Pro, adjust this in Settings > View Options > Investment-Based Returns.

Pro Issues

Pro Features Still Locked After Purchase

  1. Wait a few seconds for purchase status to update.
  2. Close and reopen Scaryfolio.
  3. Open Settings and tap Restore Purchases.
  4. Confirm you are signed in with the Apple ID used for purchase.

Cannot Restore Purchases

  • Check your App Store Apple ID.
  • Check your purchase history.
  • Try again on a stable network.

Cannot Disable a Tab

Personalization requires Pro when hiding tabs. At least one main tab must remain enabled, so the last enabled tab cannot be disabled.

Activity & Account Issues

Cannot Find Edit, Delete, or Remove Actions

Many actions are available from contextual menus instead of visible buttons. On iPhone and iPad, touch and hold an item. On Mac, right-click or Control-click an item. Contextual menus can appear for accounts, holdings, activities, cash balance entries, and watchlist items where actions are available.

Cannot Save an Account

  • Creating and editing accounts requires Pro.
  • Enter an account name.
  • Select a currency.
  • If Show Cash Balance is enabled, enter a valid initial balance. If it is disabled, a new account starts with a zero cash balance.

Cash Balance Is Hidden

Edit the account and enable Show Cash Balance to restore the cash balance card, history, and balance controls. Hiding cash balances does not delete existing cash data, and the preference synchronizes through iCloud.

Cannot Add or Edit an Activity

  • Activity write operations require Pro.
  • Check required fields such as type, date, quantity, unit price or total price, and fee where those fields are shown.
  • For buy, sell, and dividend activities, select a symbol.
  • For fee, interest, liability, or valuable activities without a symbol, enter a name.
  • Use the correct decimal separator for your region.
  • Verify the selected symbol exists in Ghostfolio.

Symbol Search Finds No Results

  • Search by ticker symbol and company name.
  • Confirm the symbol is available in Ghostfolio.
  • Some securities may not be available from the configured data source.

Watchlist Shows Premium Required or Feature Unavailable

  • Adding and removing watchlist items requires Scaryfolio Pro.
  • Ghostfolio Cloud may require Ghostfolio Premium for watchlist API access.
  • For self-hosted Ghostfolio, verify that your instance supports the watchlist API.
  • Refresh the Watchlist tab after resolving account or server access issues.

Widget Issues

Widget Shows Pro Required

Widgets require Scaryfolio Pro. Open Scaryfolio, restore purchases if needed, then refresh portfolio data.

Apple Watch Widget Shows a Ghost Image

Apple Watch widgets show a Ghost placeholder when Watch access is not configured, authentication is unavailable, or Scaryfolio Pro is not active. Confirm the Watch uses the same Apple Account, iCloud Keychain is enabled, and Pro is active, then open and refresh the Watch app.

Widget Shows Not Connected

Open Scaryfolio, connect to Ghostfolio, and refresh portfolio data. Widgets cannot complete initial setup by themselves.

Widget Data is Outdated

  • Open Scaryfolio to refresh portfolio data.
  • Allow time for the system to update the widget.
  • Make sure background refresh is allowed for Scaryfolio where applicable.
  • For the FIRE widget, open the FIRE calculator in Scaryfolio to update its settings and projections.

Mac Widgets Do Not Refresh in the Background

On Mac, Scaryfolio uses a background helper login item to refresh widget data. If widgets stop updating, check the helper from Scaryfolio before using any manual macOS troubleshooting.

  1. Open Scaryfolio Settings > Troubleshooting.
  2. Check the Background Helper health, Login Item, process, and last refresh details.
  3. If the helper is stopped, stale, or not registered, choose Repair Helper.
  4. If the helper is disabled, choose Open Login Items Settings and enable Scaryfolio.
  5. Open Scaryfolio again and allow the next widget refresh.

If Repair Helper does not resolve the issue, contact support with the helper status and Last Result shown in Settings > Troubleshooting.

Shortcuts & Spotlight Issues

Scaryfolio Actions Do Not Appear in Shortcuts

  • Open Scaryfolio at least once after installing or updating it.
  • Open the Shortcuts app and search for Scaryfolio again.
  • Restart the device if the system has not refreshed available App Intents.
  • Check that your device is running a supported OS version.

Portfolio Data Shortcut Requires Pro

Get Portfolio Value, Get Portfolio Gain, Get Portfolio Return, Get Portfolio Currency, and Get Portfolio Currency Symbol require Scaryfolio Pro. Other Scaryfolio navigation shortcuts do not require Pro.

Portfolio Data Shortcut Says to Sign In

Open Scaryfolio, connect to Ghostfolio in Settings, and confirm that portfolio data loads before running the shortcut again.

Portfolio Value or Gain Shortcut is Unavailable

Ghostfolio Zen Mode can hide absolute values. Disable Zen Mode in Ghostfolio User Settings if you want value and gain shortcuts to return absolute amounts.

Spotlight Does Not Find an Account

  • Open Scaryfolio and refresh account data.
  • Confirm the account is not excluded from analysis.
  • Allow time for Spotlight results to update.
  • Try searching by account name, currency, Account, Account Value, Cash Balance, or Scaryfolio.

Apple Watch Issues

Waiting for iCloud Settings

  • Confirm Scaryfolio Pro is active in the main app.
  • Confirm Watch and a connected device use the same Apple Account.
  • Open Scaryfolio on a main device and the Watch, then allow iCloud time to update.

Waiting for iCloud Keychain Connection

  • Connect Scaryfolio on iPhone, iPad, or Mac using the same Apple Account.
  • Enable iCloud Keychain and unlock both devices after a restart.
  • Do not disconnect unless you intend to remove the connection globally.

iCloud Account Unavailable

Check Apple Account sign-in, iCloud Keychain availability, and whether the Watch has been unlocked since restart. Then choose Retry. You do not normally need to Disconnect.

Pro Required

Restore purchases or renew Pro in the main app. Losing Pro does not disconnect Scaryfolio on your other devices.

Update Scaryfolio

Update Scaryfolio on Apple Watch, then try again.

Ghostfolio Authentication Failed

Verify or replace the Ghostfolio Security Token from a main Scaryfolio device, then try again.

Ghostfolio Server Unavailable

Check Watch internet access, the Ghostfolio server, HTTPS/proxy configuration, and custom headers.

Watch Data is Outdated

  • Open the Watch app to trigger a refresh.
  • Check that the Watch has internet access through iPhone, Wi-Fi, or cellular.
  • Confirm your Ghostfolio server is reachable.

Still Need Help?

If the issue continues, submit a support ticket from Scaryfolio Settings and include:

  • A description of the issue
  • Steps to reproduce it
  • Your platform and OS version
  • Your Scaryfolio version
  • Whether you use Ghostfolio Cloud or self-hosted Ghostfolio