> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filefetch.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Download and install FileFetch on macOS or Windows

## System Requirements

Before installing FileFetch, ensure your system meets these minimum requirements:

<Tabs>
  <Tab title="macOS">
    * **OS Version**: macOS 10.15 (Catalina) or later
    * **Architecture**: Intel or Apple Silicon (M1/M2/M3)
    * **RAM**: 4GB minimum, 8GB recommended
    * **Disk Space**: 100MB for application
    * **Internet**: Active connection for Salesforce API calls
  </Tab>

  <Tab title="Windows">
    * **OS Version**: Windows 10 (64-bit) or later
    * **Architecture**: x64 processor
    * **RAM**: 4GB minimum, 8GB recommended
    * **Disk Space**: 100MB for application
    * **Internet**: Active connection for Salesforce API calls
  </Tab>
</Tabs>

## Download FileFetch

Download the latest version of FileFetch from our website:

<Card title="Download FileFetch" icon="download" href="https://filefetch.app/download" horizontal>
  Get the free 14-day trial - no credit card required
</Card>

<Info>
  FileFetch automatically detects your operating system and provides the appropriate installer. You can also manually select your platform on the download page.
</Info>

## Installation Steps

<Tabs>
  <Tab title="macOS">
    ### Install on macOS

    <Steps>
      <Step title="Download the DMG file">
        Click **Download for macOS** to get the `.dmg` installer file
      </Step>

      <Step title="Open the DMG">
        Double-click the downloaded `FileFetch-{version}.dmg` file to mount the disk image
      </Step>

      <Step title="Drag to Applications">
        Drag the **FileFetch** app icon to the **Applications** folder shortcut

        <img src="https://mintlify.s3.us-west-1.amazonaws.com/filefetch/images/install-mac-drag.png" alt="Drag to Applications" />
      </Step>

      <Step title="Launch FileFetch">
        Open **Finder → Applications** and double-click **FileFetch**
      </Step>

      <Step title="Bypass Gatekeeper (if needed)">
        On first launch, macOS may show a security warning for apps from unidentified developers:

        1. Click **Cancel** on the warning dialog
        2. Open **System Settings → Privacy & Security**
        3. Scroll to find "FileFetch was blocked..."
        4. Click **Open Anyway**
        5. Confirm by clicking **Open** in the next dialog

        **Alternative**: Right-click FileFetch → **Open** → **Open**

        <Note>
          This only needs to be done once. Future launches will work normally.
        </Note>
      </Step>
    </Steps>

    ### Uninstall from macOS

    To remove FileFetch:

    1. **Quit FileFetch** if it's running
    2. Open **Finder → Applications**
    3. Drag **FileFetch** to the **Trash**
    4. Empty Trash

    Optional: Remove user data and settings:

    ```bash theme={null}
    rm -rf ~/Library/Application\ Support/app.filefetch.filefetch
    rm -rf ~/Library/Saved\ Application\ State/app.filefetch.filefetch.savedState
    ```
  </Tab>

  <Tab title="Windows">
    ### Install on Windows

    <Steps>
      <Step title="Download the Installer">
        Click **Download for Windows** to get the `.exe` installer file
      </Step>

      <Step title="Run the Installer">
        Double-click the downloaded `FileFetch-Setup-{version}.exe` file
      </Step>

      <Step title="Bypass SmartScreen (if needed)">
        Windows SmartScreen may show a warning for new applications:

        1. Click **More info** on the SmartScreen dialog
        2. Click **Run anyway**

        <Note>
          This warning appears because FileFetch is newly distributed. The app is safe and this step is only needed on first installation.
        </Note>
      </Step>

      <Step title="Follow Installation Wizard">
        1. Accept the license agreement
        2. Choose installation location (default recommended)
        3. Select if you want a desktop shortcut
        4. Click **Install**
      </Step>

      <Step title="Launch FileFetch">
        Click **Finish** to launch FileFetch immediately, or find it in:

        * **Start Menu → FileFetch**
        * **Desktop shortcut** (if created)
      </Step>
    </Steps>

    ### Uninstall from Windows

    To remove FileFetch:

    **Option 1: Control Panel**

    1. Open **Control Panel → Programs → Uninstall a program**
    2. Select **FileFetch** from the list
    3. Click **Uninstall** and follow the prompts

    **Option 2: Settings**

    1. Open **Settings → Apps → Apps & features**
    2. Search for **FileFetch**
    3. Click **Uninstall**

    Optional: Remove user data and settings:

    ```
    %APPDATA%\app.filefetch.filefetch
    ```
  </Tab>
</Tabs>

## Verify Installation

After installation, verify FileFetch is working correctly:

<Steps>
  <Step title="Launch the app">
    Open FileFetch from Applications (Mac) or Start Menu (Windows)
  </Step>

  <Step title="Check version">
    You should see the login screen. The version number is displayed in the bottom-left corner.

    Latest version: **v1.0.0** (as of October 2025)
  </Step>

  <Step title="Test connectivity">
    Try logging in with your Salesforce credentials to verify network connectivity
  </Step>
</Steps>

## Auto-Updates

FileFetch automatically checks for updates when you launch the app. When a new version is available:

1. You'll see an **Update Available** notification
2. Click **Download Update** to get the latest version
3. FileFetch will download the update in the background
4. Restart the app to apply the update

<Tip>
  We recommend keeping FileFetch up to date for the latest features, performance improvements, and security patches.
</Tip>

## Troubleshooting Installation

<AccordionGroup>
  <Accordion title="macOS: 'FileFetch' is damaged and can't be opened">
    **Cause**: macOS Gatekeeper is blocking the app because it's not from the Mac App Store.

    **Solution**:

    ```bash theme={null}
    xattr -cr /Applications/FileFetch.app
    ```

    Then try launching again.
  </Accordion>

  <Accordion title="macOS: App won't open after update">
    **Cause**: Sometimes macOS caches old app signatures after an update.

    **Solution**:

    1. Quit FileFetch completely
    2. Move FileFetch to Trash
    3. Empty Trash
    4. Re-download and reinstall from [filefetch.app/download](https://filefetch.app/download)
  </Accordion>

  <Accordion title="Windows: Installation blocked by antivirus">
    **Cause**: Some antivirus software may flag new installers as potentially unsafe.

    **Solution**:

    1. Temporarily disable your antivirus
    2. Run the FileFetch installer
    3. Add FileFetch to your antivirus whitelist
    4. Re-enable your antivirus

    FileFetch is safe and virus-free. Our installers are signed with a valid code-signing certificate.
  </Accordion>

  <Accordion title="Windows: 'VCRUNTIME140.dll was not found'">
    **Cause**: Missing Microsoft Visual C++ Redistributable.

    **Solution**:
    Download and install the [Microsoft Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe)

    Then reinstall FileFetch.
  </Accordion>

  <Accordion title="Installer fails with 'insufficient permissions'">
    **Cause**: You don't have administrator privileges.

    **Solution**:

    * **macOS**: You should be able to install to `~/Applications` (user Applications folder) without admin rights
    * **Windows**: Right-click the installer → **Run as administrator**

    If you still can't install, contact your IT department for assistance.
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Authenticate with Salesforce" icon="key" href="/authentication">
    Learn how to log in and connect to your Salesforce org
  </Card>

  <Card title="Quick Start Guide" icon="rocket" href="/quickstart">
    Run your first file export in 5 minutes
  </Card>
</CardGroup>

<Tip>
  Need help? Contact support at [support@filefetch.app](mailto:support@filefetch.app) or check our [Troubleshooting Guide](/troubleshooting).
</Tip>