# Installation

Packages and installation files are available at Releases page.

Alternatively, you can install the app with one of the following methods:

On Windows, you can install Chocolatey package.

On macOS (13 and above), you can use Homebrew to install the app (also see the problem in the next section):

    brew install --cask copyq

On macOS, if you encounter an issue where the app crashes with a dialog saying “CopyQ is damaged” or “CopyQ cannot be opened”, you may need to run the following commands (for details, see issue #2652):

    xattr -d com.apple.quarantine /Applications/CopyQ.app
    codesign --force --deep --sign - /Applications/CopyQ.app

On macOS, after Homebrew installation, the `copyq` CLI command is not available by default. To enable CLI access, create a symlink manually:

    sudo ln -sf /Applications/CopyQ.app/Contents/MacOS/CopyQ /usr/local/bin/copyq

After this, you can use the CLI:

    copyq --version
    copyq clipboard
    copyq size

On Debian and Ubuntu+ install a stable version from official repositories:

    sudo apt install copyq
    # copyq-plugins and copyq-doc is split out and can be installed independently

On Fedora, install “copyq” package:

    sudo dnf install copyq

On other Linux distributions, you can download the AppImage from the Releases page:

    chmod +x CopyQ-*.AppImage
    ./CopyQ-*.AppImage

Alternatively, you can use Flatpak to install CopyQ from Flathub. See Flathub Setup for initial Flatpak/Flathub configuration.

To start CopyQ from the command line:

    flatpak run com.github.hluk.copyq