This guide describes how to get started and install EJBCA with the provided quick setup script to run locally.
For testing purposes, you can also use the EJBCA Virtual Machine (VM) available for download from ejbca.org, see www.ejbca.org/download.
Quick Setup Script
To install EJBCA using the quick setup script located in bin/extra/ejbca-setup on a Linux machine (Ubuntu or RedHat is recommended), do the following:
sudo apt-get update
sudo apt-get install unzip openjdk-
-jdk-headless ant ant-optional psmisc mariadb-client bc patch curl
sudo update-java-alternatives --set java-
Note that EJBCA currently (up to and including EJBCA 7.0) does not support Java 11. If running on a platform that comes with Java 11 by default, such as Ubuntu 18.04, switch to using Java 8 by running the following:
> sudo update-java-alternatives --set java-1.8.0-openjdk-amd64
sudo yum install tar unzip java-
-openjdk-devel ant psmisc mariadb bc patch
Download EJBCA and unpack the ZIP archive in the ejbca install directory:
$ unzip ejbca_ee_7_X_X_X.zip -d <installdir>
$ cd <installdir>
Install a MariaDB database and create a database for EJBCA:
$ sudo mysql -u root -p
mysql> CREATE DATABASE ejbcatest CHARACTER SET utf8 COLLATE utf8_general_ci;
mysql> GRANT ALL PRIVILEGES ON ejbcatest.* TO
Configure the script in ejbca/bin/extra/ejbca-setup with your database user and password.
Run the script with ./<ejbca-install-directory>/bin/extra/ejbca-setup according to the following example:
Do not run the ejbca-setup script from inside the EJBCA directory. The script creates new directories and links, and is thus dependent on being run from just outside the EJBCA directory itself.
The script will download WildFly 10 and the MariaDB database connector and install everything, resulting in a usable EJBCA installation.
Import superadmin.p12 in your web browser using the password printed on the last line after running the script. Then open the EJBCA Administration Web at https://localhost:8443/ejbca/adminweb/.
Feedback and improvements to the ejbca-setup script are appreciated.