XCA 2.7.0
XCA - X Certificate and Key Management
Release Notes
- The latest release is 2.7.0
- Drivers for SQL Servers must be installed separately since 2.5.0
- Database Schema changed and is not backwards-compatible. Backup your database.
- Please report issues on github https://github.com/chris2511/xca/issues
Changelog:
A detailled changelog can be found here:
https://hohnstaedt.de/xca/index.php/software/changelog
Documentation
This application is documented in the Help menu and here:
https://www.hohnstaedt.de/xca/index.php/documentation/manual
Build from Source
Dependencies
To build XCA you need:
- a toolchain
- cmake: https://cmake.org
- Qt5 or Qt6: https://www.qt.io
- OpenSSL: https://www.openssl.org (1.1.1 or higher)
or libressl-3.6.x - Sphinx-Build: https://www.sphinx-doc.org
Linux / Unix
- Install the dependencies
# Bookworm sudo apt install build-essential libssl-dev pkg-config cmake qttools5-dev python3-sphinxcontrib.qthelp # Bullseye sudo apt install build-essential libssl-dev pkg-config cmake qttools5-dev python3-sphinx # Either Qt5 sudo apt install qtbase5-dev qttools5-dev-tools libqt5sql5 libqt5help5 qttools5-dev # Or Qt6 sudo apt install qt6-base-dev qt6-tools-dev
- Clone:
git clone https://github.com/chris2511/xca.git
- Configure:
cmake -B build xca
- Make:
cmake --build build -j5
- Install:
sudo cmake --install build
- Or install local and copy later as root:
DESTDIR=DEST cmake --install build --prefix /usr
Apple macos
- Install the dependencies
xcode-select --install brew install openssl@3 qt6 python3 cmake pip3 install sphinx
- Clone:
git clone https://github.com/chris2511/xca.git
- Configure:
cmake -B build xca
- Make:
cmake --build build -j5
- Build the DMG:
cd build && cpack
- Build the PKG:
cd build && cpack -G productbuild
XCA can be used with Xcode after initializing the directory with:
cmake -G Xcode -B .
Windows
-
Install the dependencies
- Install Python for windows from the store or https://www.python.org/downloads/windows/
- Install OpenSSL from here: https://slproweb.com/download/Win64OpenSSL-3_1_5.msi and verify the sha256 from https://github.com/slproweb/opensslhashes/blob/master/win32_openssl_hashes.json
- To install the Qt libraries, cmake and the MinGW compiler aqtinstall is used.
Sphinx is used to generate the documentationpip3 install sphinx aqtinstall
- Add the PATH shown by pip to your PATH
- Install Qt, cmake and the MinGW toolchain
aqt install-qt windows desktop 6.6.3 win64_mingw aqt install-tool windows desktop tools_mingw90 qt.tools.win64_mingw900 aqt install-tool windows desktop tools_vcredist qt.tools.vcredist_64
- If 7z is missing, install it from the store.
7-Zip File Manager (unofficial)
or from 7-zip.org - Install the "vcredist\vcredist_64.exe"
- Add cmake, MinGW, OpenSSL and Qt6 to your Path
%USERPROFILE%\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\Scripts; %USERPROFILE%\AppData\Local\Microsoft\WindowsApps; %USERPROFILE%\Tools\CMake_64\bin; %USERPROFILE%\Tools\mingw_64\bin; %USERPROFILE%\6.6.3\mingw_64\bin;
- Create
CMAKE_PREFIX_PATH
environment variable:%USERPROFILE%\6.6.3\mingw_64\lib\cmake
- Install
https://wixtoolset.org/releases/
if you want to create the MSI installer
-
Clone:
git clone https://github.com/chris2511/xca.git
-
Configure:
cmake -B build -G "MinGW Makefiles" xca
-
Make:
cmake --build build -j5
-
Create the Portable App:
cmake --build build -t install
-
Build the MSI installer (and the Portable App):
cd build ; cpack
SQL Remote Database Drivers
MySQL plugins are not shipped with QT anymore because of license issues.
Linux
- Debian:
libqt6sql6-psql
libqt6sql6-mysql
orlibqt6sql6-odbc
. - RPM:
libqt6-database-plugin-pgsql
libqt6-database-plugin-mysql
libqt6-database-plugin-odbc
They should pull in all necessary dependencies.
Apple macos
- PostgreSQL: Install the https://postgresapp.com/
- ODBC: It requires the
/usr/local/opt/libiodbc/lib/libiodbc.2.dylib
.
When installing unixodbc viabrew
the library must be symlinked from
/opt/homebrew/Cellar/libiodbc/3.52.16/lib/libiodbc.2.dylib
- MariaDB: Probably via ODBC ?
Windows
- PostgreSQL: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads (Commandline tools).
Add thebin
directory of the Postgres installation directory to your PATH (C:\Program Files\PostgreSQL\16) - ODBC: Use the
ODBC Datasources 64bit app
to configure the SQL Server - MariaDB (MySQL): Install the Plugin from here: https://github.com/thecodemonkey86/qt_mysql_driver.
Select the MinGW variant and install it as documented.