mirror of
https://github.com/chris2511/xca.git
synced 2026-09-14 11:06:19 +05:00
135 lines
5.3 KiB
Markdown
135 lines
5.3 KiB
Markdown
# XCA -- X Certificate and Key Management
|
|
|
|
[](https://github.com/chris2511/xca/actions/workflows/cmake.yaml)
|
|
|
|
## __Release Notes__
|
|
* The latest release is *2.5.0*
|
|
* Drop support for Qt4, old XCA < 2.0.0 databases and OpenSSL < 1.1.0
|
|
* Drivers for SQL Servers must be [installed separately](#sql-remote-database-drivers) since 2.5.0
|
|
* Keys created in XCA databases < 2.0.0 must be [converted](https://github.com/chris2511/xca/discussions/468) with XCA < 2.5.0
|
|
* Add Support for Qt6 and OpenSSL 3.x
|
|
* Switch from autotools/qmake to cmake
|
|
* Fix a lot of bugs (and probably added some new)
|
|
* Add translations for Indonesian, Persian and Bulgarian
|
|
* 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)
|
|
- Sphinx-Build: https://www.sphinx-doc.org
|
|
|
|
### Linux / Unix
|
|
|
|
- Install the dependencies
|
|
```
|
|
# Bookworm
|
|
sudo apt install build-essential libssl-dev pkg-config qtbase5-dev qttools5-dev-tools libqt5sql5 libqt5help5 cmake qttools5-dev python3-sphinxcontrib.qthelp
|
|
# Bullseye
|
|
sudo apt install build-essential libssl-dev pkg-config qtbase5-dev qttools5-dev-tools libqt5sql5 libqt5help5 cmake qttools5-dev python3-sphinx
|
|
```
|
|
- 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_0_8.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](https://github.com/miurahr/aqtinstall) is used.
|
|
Sphinx is used to generate the documentation
|
|
```
|
|
pip3 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.0 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 Qt5 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%\5.15.2\mingw_64\bin;
|
|
```
|
|
- Create `CMAKE_PREFIX_PATH` environment variable:
|
|
```
|
|
%USERPROFILE%\6.6.0\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` or `libqt6sql6-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 via `brew` 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 the `bin` 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.
|