Installation

Visit the download page of the digiKam Web site for up to date information on installing the current version of digiKam.

You’ll find all previous digiKam versions in the attic.

Note

Bundles with -debug in the file-name include debug symbols to catch debugger traces when the application stops working. These debug files are large but they can will help developers find and fix coding errors. See the Get Involved section for details.

Minimum System Requirements

  • Operating System: 64-bit Windows 10 or newer, Apple macOS 64-bit based on Intel or Apple Silicon (M1 or later), 64-bit Linux. See details below.

  • CPU: x86 Intel, AMD, or Arm; at least one 2 GHz core for standard photo processing, 4 cores for large photo or panorama processing, 8 cores for deep-learning capabilities such as face detection, image quality sorting, and auto-tags. See details below.

  • GPU: OpenGL 2.0 that works correctly and is compatible. On Windows, you can also use a card with good, compatible DirectX 9 or 11 drivers.

  • RAM: At least 4 GB for standard photo processing, 8 GB for large photo or panorama processing, 16 GB for deep-learning capabilities such as face management, image quality sorting, and auto-tags. See details below.

Note

If your computer is at the lower end of the CPU and RAM requirements, you should use both Small Thumbnails Resolution and Loading Embedded Preview features to help reduce preview lag.

  • Monitors: Although the application can be used on a single screen, using multi-screens will improve the experience especially when reviewing items.

A Double-Screen Linux Station with Main Window on the Left and Light Table on the Right

Tip

If your screen provides HDPI support, check options Use high DPI scaling from the screen factor and Application font.

  • Storage: NVMe and SSD are the best choice for robust and speedy hosting of the digiKam database and collection.

digiKam on Linux

digiKam can be installed on non-KDE Desktops without any issues. The application is offered in the form of 2 binaries:

  • Qt6 as main version based on last Qt framework. The minimum Ubuntu 22.04 has no such minimal requirements.

  • Qt5 as prior version based on older Qt framework. The minimum Ubuntu 20.04 has no such minimal requirements.

AppImage is a bundle hosting all the necessary dependencies to run digiKam. Nothing else is installed on your system. Turn on the executable property of the AppImage file and run it. That’s all…

Screencast of AppImage Startup

Tip

The AppImage bundle also includes the Showfoto stand Alone Image Editor. To run it, instead of digiKam, just add showfoto as an argument to the AppImage command line, like this:

./digiKam-X.Y.Z-Qt6-x86-64.appimage showfoto

Note

The AppImage bundle provides more startup options which can be listed with the help argument from the command line.

digiKam on Windows

Using on a Standard Desktop

digiKam runs only on 64-bit versions of Windows 10 and newer. We cannot guarantee that digiKam runs on server or embedded versions of Windows.

The application is offered in the form of 2 installers:

  • Qt6 as main version based on last Qt framework.

  • Qt5 as prior version based on older Qt framework.

digiKam is available as a non-signed installable (Setup Program) version and as a standalone (Archive) version.

  • Installable version: Needs administrator rights and gets installed on your local machine. It’s also listed as a program.

    • It’s available for all users on your computer.

    • The digiKam files are always located in the same folder.

    When the file is downloaded, and the installer is started, a security warning will appear because the installer does not come from the Windows Store.

    The Windows Warning When you Try to Run digiKam Installer after Downloading

    You need to set the Windows Config Panel/Applications and Features to allow applications to be installed from sources outside the Microsoft store.

    The Windows Applications and Features Panel to Authorize digiKam Installation

    Because the installer is not signed, Microsoft Windows Defender will display an information dialog when the installer is started a second time.

    The Windows Information When you Run digiKam Installer

    Once the installer is running, follow the instructions from the assistant to install digiKam on your computer.

    Note

    If a previous version of digiKam is present on your system, the Windows installer will warn you to uninstall the previous version before proceeding with the new installation.

    The Windows Warning When you Try to Install digiKam When a Previous Version is Present

    The Windows Dialog to Uninstall Previous Version of digiKam

    The Windows Dialog to Install Newer Version of digiKam

  • Standalone version: Doesn’t need administrator rights and isn’t installed or listed as a program. Is only accessible by the user who has downloaded the file.

    • Allows a normal user to use digiKam without a full installation.

    • You can also copy the digiKam folder onto any external drive and run it on a different computer without installing it. However, your personal settings and downloads within digiKam are limited to the computer you work on.

Using in a Windows Domain

If you want to use digiKam with domain users based on Windows Active Directory and/or Group Policies (GPOs) make sure all users have read/write access to the following folders:

%AppData%\digikam

%LocalAppData%\digikam

%LocalAppData%\digikamrc

%LocalAppData%\digikam_systemrc

%LocalAppData%\kxmlgui5\digikam\digikamui.rc

Similar requirements also exist for the Showfoto stand Alone Image Editor:

%AppData%\showfoto

%LocalAppData%\showfoto

%LocalAppData%\showfotorc

%LocalAppData%\showfoto_systemrc

%LocalAppData%\kxmlgui5\digikam\showfotoui.rc

Also make sure no GPO is blocking the access to these folders.

digiKam on macOS

The non-Signed Package

digiKam runs with on Apple-silicon based Macs (Qt6) and also on legacy Intel-based Macs 64-bit (Qt5). Minimum system requirements depend on the version of digiKam being installed:

digiKam version

Qt version

Supported macOS Release

>= 8.5.0

Qt6 and Qt5

macOS 11.3 Silicon and Intel (BigSur) or newer

>= 7.10.0

Qt5 only

macOS 10.15 Intel (Catalina) or newer

>= 7.0.0

Qt5 only

macOS 10.13 Intel (High Sierra) or newer

>= 6.4.0

Qt5 only

macOS 10.12 Intel (Sierra) or newer

>= 6.1.0

Qt5 only

macOS 10.11 Intel (El Capitan) or newer

>= 6.0.0

Qt5 only

macOS 10.8 Intel (Mountain Lion) or newer

Note

Macports , which was used to build the digiKam PKG, has a rolling release policy making it difficult to provide binary compatibility with older versions of macOS. Macports packages are frequently updated for security reasons, and this can require a more recent macOS SDK.

When the PKG file is downloaded, and the installer is started, Apple Gatekeeper will display a security warning because the package is not signed.

The macOS Warning When you Try to Run the digiKam Installer after Downloading

You need to allow the installer to run by clicking on Open Anyway in the macOS Config Panel/Security and Privacy dialog.

The macOS Security Panel to Authorize digiKam PKG Installation

Once the installer is running, follow the instructions from the assistant to install digiKam onto your computer.

The digiKam macOS PKG is running and Ready to Install

Application Permissions

Once installed, digiKam will need to access some system resources to run properly. The system will ask for permissions when digiKam is run, depending on actions performed by user. See below for some examples of permissions that may need to be set in the macOS Security and Privacy policy configuration panel:

  • Automation: You must allow digiKam to control Apple’s Finder app when you try to open an album in the Finder file manager through digiKam.

The macOS Security and Privacy Panel with the Automation Permissions

  • Accessibility: You must allow digiKam to control your computer if you want to change the desktop wallpaper with digiKam.

The macOS Security and Privacy Panel with the Accessibility Permissions

  • Files And Folders: You must allow digiKam to access files and folders outside the Photos directory, if you place your collections elsewhere on your computer.

The macOS Security and Privacy Panel with the Files and Folders Access Rights

  • Full Disk: You must allow digiKam to access data from other applications if you use the gPhoto2 driver to communicate with your camera.

The macOS Security and Privacy Panel with the Full Disk Access Permissions

  • Photos: You must allow digiKam to access your photos if you want digiKam to include the Apple Photos collection in your personal account.

The macOS Security and Privacy Panel with the Photos Access Permissions

Note

When digiKam is first run, if you point your collection to the standard Apple Photo library, MacOS will automatically ask you to grant access to the library.

The macOS dialog to grant access to Apple Photo library

Configuration Files

digiKam’s application-wide persistent settings are stored in the following locations, depending on your platform.

Linux

Windows

macOS

Description

~/.config/digikamrc

%LocalAppData%\digikamrc

~/Library/Preferences/digikamrc

General settings for the application. Delete this and restart digiKam to reset the application to factory settings

~/.config/digikam_systemrc

%LocalAppData%\digikam_systemrc

~/Library/Preferences/digikam_systemrc

System settings for the application. Delete this and restart digiKam to reset the application to factory settings

~/.cache/digikam

%LocalAppData%\digikam

~/Library/Caches/digikam

Cache location storing temporary files

~/.local/share/digikam

%AppData%\digikam

~/Library/Application Support/digikam

Contains downloaded deep-learning models and internal configuration files

~/.local/share/kxmlgui5/digikam/digikamui5.rc

%LocalAppData%\kxmlgui5digikam\digikamui5.rc

~/Library/Application Support/digikam/kxmlgui5/digikam/digikamui5.rc

Contains UI configuration. If your UI is broken, delete this file

Similar to digiKam, the Showfoto stand Alone Image Editor also has persistent settings stored at the following locations:

Linux

Windows

macOS

Description

~/.config/showfotorc

%LocalAppData%\showfotorc

~/Library/Preferences/showfotorc

General settings for the application. Delete this and restart Showfoto to reset the application to factory settings

~/.config/showfoto_systemrc

%LocalAppData%\showfoto_systemrc

~/Library/Preferences/showfoto_systemrc

System settings for the application. Delete this and restart Showfoto to reset the application to factory settings

~/.cache/showfoto

%LocalAppData%\showfoto

~/Library/Caches/showfoto

Cache location storing temporary files

~/.local/share/showfoto

%AppData%\showfoto

~/Library/Application Support/showfoto

Contains downloaded deep-learning models and internal configuration files

~/.local/share/kxmlgui5/showfoto/showfoto ui5.rc

%LocalAppData%\kxmlgui5showfoto\showfotoui5.rc

~/Library/Application Support/showfoto/kxmlgui5/showfoto/showfotoui5.rc

Contains UI configuration. If your UI is broken, delete this file

Note

The character ‘~’ indicates the home directory on the system of the current user.

Application Updates

Important

If you update digiKam to a new major version, for example from version 7 to version 8, we recommend you first backup your database files, since the internal schema may have changed. Typically, digiKam is able to migrate tables from an older version to a new one, and all of this is done automatically at startup. But it’s always better to save these important digiKam files before upgrading the application. See the Database Backup section in this manual for more recommendations.

If you use a bundle such as the official Linux AppImage, macOS package, or Windows installer, the application can be updated using the Help ‣ Check For New Version menu entry. See the updates settings on the Behavior page of the configuration dialog.

The Dialog to Update Application Using Online Weekly Builds