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.
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…
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.
You need to set the Windows Config Panel/Applications and Features to allow applications to be installed from sources outside the Microsoft store.
Because the installer is not signed, Microsoft Windows Defender will display an information dialog when the installer is started a second time.
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.
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.
You need to allow the installer to run by clicking on Open Anyway in the macOS Config Panel/Security and Privacy dialog.
Once the installer is running, follow the instructions from the assistant to install digiKam onto your computer.
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.
Accessibility: You must allow digiKam to control your computer if you want to change the desktop wallpaper with digiKam.
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.
Full Disk: You must allow digiKam to access data from other applications if you use the gPhoto2 driver to communicate with your camera.
Photos: You must allow digiKam to access your photos if you want digiKam to include the Apple Photos collection in your personal account.
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.
Configuration Files¶
digiKam’s application-wide persistent settings are stored in the following locations, depending on your platform.
Linux |
Windows |
macOS |
Description |
---|---|---|---|
|
|
|
General settings for the application. Delete this and restart digiKam to reset the application to factory settings |
|
|
|
System settings for the application. Delete this and restart digiKam to reset the application to factory settings |
|
|
|
Cache location storing temporary files |
|
|
|
Contains downloaded deep-learning models and internal configuration files |
|
|
|
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 |
---|---|---|---|
|
|
|
General settings for the application. Delete this and restart Showfoto to reset the application to factory settings |
|
|
|
System settings for the application. Delete this and restart Showfoto to reset the application to factory settings |
|
|
|
Cache location storing temporary files |
|
|
|
Contains downloaded deep-learning models and internal configuration files |
|
|
|
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 on the Behavior page of the configuration dialog.
. See the updates settings