Installation and Setup

Installation & Setup

This guide covers installing CyberFeeds, building from source, and keeping it up to date.

---

System Requirements

Requirement	Minimum
OS	Windows 10 (64-bit) or later
Architecture	x64
Runtime	None (Electron bundles all dependencies)
Disk space	~150 MB
RAM	4 GB

---

Installation Methods

Installer (Recommended)

1. Download the latest installer from Releases
2. Run the .exe installer
3. Follow the setup wizard
4. Launch CyberFeeds

What the Installer Does

• Installs the application
• Creates Start Menu shortcuts
• Creates Desktop shortcut (optional)

Windows SmartScreen

Windows may show a SmartScreen warning the first time you run the CyberFeeds installer; this is expected until Windows builds enough reputation for the file.

To continue:

1. Click More info.
2. Click Run anyway.

---

Building from Source

Prerequisites

Tool	Version
Node.js	18+
npm	Latest

Setup

# Clone the repository
git clone https://github.com/CyberGems/CyberFeeds.git
cd CyberFeeds

# Install dependencies
npm install

# Run in development mode
npm run dev

Build for Production

# Build for Windows
npm run build:win

# Build unpacked directory
npm run build:unpack

Build Outputs

Output	Location
NSIS Installer	dist/
Unpacked	dist/win-unpacked/

---

Auto-Start

CyberFeeds can launch automatically when you sign in:

Enable/Disable

• Settings → General → Auto-start with Windows
• Or: Windows Settings → Apps → Startup → Toggle CyberFeeds

---

Auto-Update

How It Works

1. CyberFeeds periodically checks GitHub Releases for new updates
2. When an update is detected, an interactive update dialog appears with an instant changelog peek showcasing release highlights
3. You can choose to install immediately, review full release notes in your browser, or skip the current release version

Update Settings

Setting	Description
Auto-update	Enable/disable automatic checking

Manual Update

1. Open the About CyberFeeds dialog and choose Check for updates
2. Or: Download the latest installer from GitHub Releases

---

Data Location

Default Locations

Data	Location
Database and settings	%APPDATA%\CyberFeeds\cybersfeeds.db
Database sidecar files	%APPDATA%\CyberFeeds\cybersfeeds.db-wal and %APPDATA%\CyberFeeds\cybersfeeds.db-shm while the app is running

Settings, feed subscriptions, articles, and notification history are stored in the SQLite database. Development builds use %APPDATA%\CyberFeeds-dev.

CyberFeeds currently ships as an assisted Windows installer. A portable build is not included in the release packages.

---

Uninstallation

Standard Uninstall

1. Windows Settings → Apps → Installed Apps
2. Find CyberFeeds → Click Uninstall

What Gets Removed

• Program files
• Start Menu shortcuts
• Auto-start entry

What Is Kept

• Database and settings (in %APPDATA%\CyberFeeds)

⚠️ To remove all data, manually delete %APPDATA%\CyberFeeds after uninstalling.