diff --git a/EPD-Assertion-Provider-Simulator/installation.md b/EPD-Assertion-Provider-Simulator/installation.md
new file mode 100644
index 0000000000000000000000000000000000000000..566a9900b9da2c867eb5b2951d40a21479899c4d
--- /dev/null
+++ b/EPD-Assertion-Provider-Simulator/installation.md
@@ -0,0 +1,157 @@
+---
+title:  User Manual
+subtitle: Assertion Provider Simulator
+author: Youn Cadoret
+function: Developer
+date: 28/06/2019
+toolversion: 1.1
+version: 0.01
+status: to be reviewed
+reference: KER1-MAN-IHE-ASSERTION_PROVIDER_SIMULATOR_INSTALLATION_USER
+customer: IHE-EUROPE
+---
+
+# EPR Assertion Provider MockUp
+
+## Overview
+
+The EPR Assertion Provider MockUp is a SoapUI webservice (mock) that provides SAML Assertion when requested.
+The Assertion Provider is based on a backend Java library net.ihe.gazelle.XUAGenerator that need to be deployed on the running SoapUI.
+
+* default_wsdl_url: http://ehealthsuisse.ihe-europe.net:8090/STS?wsdl
+* default_path: /STS
+* default_port: 8090
+* default_mock_name: STSBindingMockService
+* default_mock_path: /opt/simulators/epr-assertion-provider-mockup
+* default_soapui_path: /usr/local/SmartBear/SoapUI-5.3.0/
+* default_soapui_mock_log: /var/log/soapui/epr-assertion-provider.log
+* default_init.d: /etc/init.d/mock-eCH-XUAGenerator
+* default_keystore_path: /opt/gazelle/cert/jboss.jks
+
+
+## Install SoapUI
+
+[https://www.soapui.org/](https://www.soapui.org/)
+
+## Install EPR SAML Generator project
+
+### Get the Subversion project
+
+```bash
+svn checkout https://scm.gforge.inria.fr/anonscm/svn/gazelle/EPD/trunk/epr-saml-generator/ $SAMLGENERATOR_DIR
+```
+
+### Deploy EPR SAML Generator in SoapUI
+
+Build the projet
+
+```bash
+cd $SAMLGENERATOR_DIR
+mvn clean package
+```
+
+Copy the jar into the external SoapUI intallation dir
+
+```bash
+cp target/epr-saml-generator-X.X.X-jar-with-dependencies.jar $SOAPUI_INSTALL_DIR/bin/ext/.
+```
+
+## Install EPR Assertion Provider MockUp
+
+### Get the Subversion project
+
+```bash
+svn checkout https://scm.gforge.inria.fr/anonscm/svn/gazelle/EPD/trunk/epr-assertion-provider-mockup/ $EPR_AP_MOCK_DIR
+```
+
+### Install libraries required by SoapUI
+
+Copy the external jars (esapi, velocity and postgresql)
+
+```bash
+cp $EPR_AP_MOCK_DIR/external_jar/esapi-2.1.0.1.jar $SOAPUI_INSTALL_DIR/lib/
+cp $EPR_AP_MOCK_DIR/external_jar/velocity-1.7.jar $SOAPUI_INSTALL_DIR/lib/
+cp $EPR_AP_MOCK_DIR/external_jar/postgresql-9.3-1102.jdbc4.jar $SOAPUI_INSTALL_DIR/lib/
+```
+
+### Prepare the database
+
+Database is not mandatory, but if not configured, it will raise log errors for each recieving request.
+
+```bash
+psql -U gazelle postgres
+> CREATE DATABASE "assertion-provider" OWNER gazelle ;
+> \q
+psql -U gazelle assertion-provider < $EPR_AP_MOCK_DIR/sql/schema.sql
+```
+
+## Mock as a service
+
+### Prepare the init.d script
+
+Edit the init.d script `$EPR_AP_MOCK_DIR/init.d/assertionProviderMock` and set the following environment variables
+
+* SOAPUI_PATH => Path of SoapUI folder
+* SOAPUI_PROJECT_PATH => Path of SoapUI project script
+* SOAPUI_MOCK_NAME => Name of the SoapUI mock
+* SOAPUI_MOCK_PORT => Port of the SoapUI mock
+* SOAPUI_MOCK_ENDPOINT => Path of the SoapUI mock
+* SOAPUI_MOCK_LOG => Path where to publish log file
+
+### Declare the service
+
+Type the following commands register the init.d script as service
+
+```bash
+sudo cp $EPR_AP_MOCK_DIR/init.d/assertionProviderMock /etc/init.d/assertionProviderMock
+sudo chmod u+x /etc/init.d/assertionProviderMock
+sudo chmod 775 /etc/init.d/assertionProviderMock
+```
+
+If you want the service to start at each machine start up
+
+```bash
+sudo update-rc.d assertionProviderMock defaults
+```
+
+Be careful to allow the service to write logs into your target directory. As example
+
+```bash
+sudo mkdir /var/log/soapui
+sudo chmod 775 /var/log/soapui
+```
+
+### Start the mock
+
+To run the mock
+
+```bash
+sudo /etc/init.d/assertionProviderMock start
+```
+
+To stop the mock
+
+```bash
+sudo /etc/init.d/assertionProviderMock stop
+```
+
+To get status of the mock
+
+```bash
+sudo /etc/init.d/assertionProviderMock status
+```
+
+
+## Troubleshouting
+
+You might need to install those following packets
+
+```bash
+sudo apt-get install -y libxrender1 libxtst6 libxi6
+```
+
+You might need to resolve errors when starting the mock
+
+```bash
+sudo mv /root/.soapuios/ /root/.soapuios_old
+```
diff --git a/EPD-Assertion-Provider-Simulator/user.md b/EPD-Assertion-Provider-Simulator/user.md
new file mode 100644
index 0000000000000000000000000000000000000000..ed6b133a1cf3d4c9b895fe06b4645e4ccdc12001
--- /dev/null
+++ b/EPD-Assertion-Provider-Simulator/user.md
@@ -0,0 +1,13 @@
+---
+title:  User Manual
+subtitle: Assertion Provider Simulator
+author: Youn Cadoret
+function: Developer
+date: 28/06/2019
+toolversion: 1.1
+version: 0.01
+status: to be reviewed
+reference: KER1-MAN-IHE-ASSERTION_PROVIDER_SIMULATOR_USER
+customer: IHE-EUROPE
+---
+