# Install Octoclip

This page describes how to complete Octoclip installation across platforms, how to verify a successful install, and what to check first if you encounter problems during the process.

## System Requirements

To ensure Octoclip runs correctly, verify your device meets these minimum OS requirements:
*   **Windows:** Windows 10 (1809+) or newer (64-bit)
*   **macOS:** macOS 11.0 (Big Sur) or newer
*   **Android:** Android 8.0 or newer
*   **iOS / iPadOS:** iOS 15.0 or newer

> [!WARNING] Install Only from Official Sources
> Install only via the [Official Download Page](https://octoclip.app/download) or its linked official application stores. Do not use repackaged installers or unknown links to prevent security and data risks.

To complete your first cross-device copy/paste cycle, **we recommend installing the app on at least two devices**.

## Verification Steps

:::steps
:::step{title="Confirm application entry"}

:::tabs
:::tab{label="Windows"}
Launch the application and verify that the Octoclip icon is visible in your system tray (bottom-right corner).
:::
:::tab{label="macOS"}
Open the app from Applications and verify that the Octoclip icon is visible in your status menu bar (top-right corner).
:::
:::tab{label="Android"}
Verify that the Octoclip icon appears on your home screen or drawer. Grant notifications and autostart/battery optimization permissions as requested.
:::
:::tab{label="iOS"}
Verify that the Octoclip icon appears on your Home Screen. Allow clipboard access when prompted during the first launch.
:::
:::

:::
:::step{title="Perform a local copy"}

On your current device, copy a short text snippet (e.g., `octoclip-test`).

:::
:::step{title="Verify clipboard history capture"}

**Success sign:** Open Octoclip's main history window (or open the app/pull down history on iOS). Confirm that your copied text is recorded as the top plain text card in the list.
:::
:::

## Installation Troubleshooting

:::accordion{multiple}
:::item{label="File download fails or package is corrupted"}

Return to the [Official Download Page](https://octoclip.app/download) and download a fresh installer. Do not attempt to run a partially downloaded or interrupted setup file.

:::
:::item{label="Setup runs but app fails to launch"}

1. Restart your device first.
2. Check your system security settings (e.g., Windows SmartScreen or macOS Security & Privacy) to ensure the app is allowed to run.
3. If on a corporate device, security tools or group policies might block the installation. Contact your IT administrator or check block logs.

:::
:::item{label="Android: APK install blocked"}

Some Android devices warn against installing direct APK files. You must allow "Install unknown apps" from your browser or file manager settings to proceed. If available, prefer installing via your system's app store.

:::
:::

## Next steps

:::cards{cols=2}
:::card{title="Copy & Paste" icon="lucide.play" href="/getting-started/first-steps"}
Learn how to copy, edit, and paste clips locally on one device.

:::
:::card{title="Cross-device Sync" icon="lucide.copy" href="/getting-started/first-cross-device-paste"}
Set up sync to complete your first cross-device clipboard validation.
:::
:::

## Still Not Solved

If you encounter issues during installation, please provide the following details when posting in the community:

*   **OS Platform & Version:** (e.g., Windows 11 23H2 / iOS 17.2)
*   **Octoclip Version:** (if readable)
*   **Install Source:** (e.g., Official Website Direct / App Store / Play Store)
*   **Detailed Symptom:** (e.g., app crashes on open / "corrupted installer" warning / copied text not captured)