diff --git a/CKAN_User_Guide_Template.xml b/CKAN_User_Guide_Template.xml
new file mode 100644
index 0000000..c0ac381
--- /dev/null
+++ b/CKAN_User_Guide_Template.xml
@@ -0,0 +1,544 @@
+
+
+ This is a template for a basic flow to use NgsiLdToCkan processor.
+ bf133a52-6939-155f-6af5-a1c827baea7d
+ CKAN User Guide Template
+
+
+ 5894b471-2aa7-30d8-0000-000000000000
+ a191897b-2b00-3c65-0000-000000000000
+ 1 GB
+ 10000
+
+ a191897b-2b00-3c65-0000-000000000000
+ cff93d35-3836-3f2e-0000-000000000000
+ PROCESSOR
+
+ 0 sec
+ 1
+ DO_NOT_COMPRESS
+
+ LOAD_BALANCE_NOT_CONFIGURED
+ DO_NOT_LOAD_BALANCE
+
+ success
+
+ a191897b-2b00-3c65-0000-000000000000
+ 3e9e23c8-68ff-3697-0000-000000000000
+ PROCESSOR
+
+ 0
+
+
+ ba043a74-6357-3f20-0000-000000000000
+ a191897b-2b00-3c65-0000-000000000000
+ 1 GB
+ 10000
+
+ a191897b-2b00-3c65-0000-000000000000
+ 3e9e23c8-68ff-3697-0000-000000000000
+ PROCESSOR
+
+ 0 sec
+ 1
+ DO_NOT_COMPRESS
+
+ LOAD_BALANCE_NOT_CONFIGURED
+ DO_NOT_LOAD_BALANCE
+
+ success
+
+ a191897b-2b00-3c65-0000-000000000000
+ 4b6bb8c0-6b7f-34c4-0000-000000000000
+ PROCESSOR
+
+ 0
+
+
+ 3e9e23c8-68ff-3697-0000-000000000000
+ a191897b-2b00-3c65-0000-000000000000
+
+ 0.0
+ 232.0
+
+
+ nifi-update-attribute-nar
+ org.apache.nifi
+ 1.27.0
+
+
+ PENALIZE_FLOWFILE
+ WARN
+
+ 1
+
+
+ Delete Attributes Expression
+
+ Delete Attributes Expression
+
+
+
+ Store State
+
+ Store State
+
+
+
+ Stateful Variables Initial Value
+
+ Stateful Variables Initial Value
+
+
+
+ canonical-value-lookup-cache-size
+
+ canonical-value-lookup-cache-size
+
+
+
+ datasetTitle
+
+ datasetTitle
+
+
+
+ keywords
+
+ keywords
+
+
+
+ landingPage
+
+ landingPage
+
+
+
+ organizationType
+
+ organizationType
+
+
+
+ themes
+
+ themes
+
+
+
+ ALL
+ false
+ 10 mins
+ 30 sec
+
+
+ Delete Attributes Expression
+
+
+ Store State
+ Do not store state
+
+
+ Stateful Variables Initial Value
+
+
+ canonical-value-lookup-cache-size
+ 100
+
+
+ datasetTitle
+ Experimental Dataset
+
+
+ keywords
+ ["data", "keeper"]
+
+
+ landingPage
+ https://test.org
+
+
+ organizationType
+ Experimental Publisher
+
+
+ themes
+ Experimental Theme
+
+
+ 10
+ 25
+ 0 sec
+ TIMER_DRIVEN
+ 1 sec
+
+ false
+ UpdateAttribute
+
+ false
+ success
+ false
+
+ RUNNING
+
+ org.apache.nifi.processors.attributes.UpdateAttribute
+
+
+ 4b6bb8c0-6b7f-34c4-0000-000000000000
+ a191897b-2b00-3c65-0000-000000000000
+
+ 0.0
+ 0.0
+
+
+ nifi-standard-nar
+ org.apache.nifi
+ 1.27.0
+
+
+ PENALIZE_FLOWFILE
+ WARN
+
+ 1
+
+
+ Base Path
+
+ Base Path
+
+
+
+ Listening Port
+
+ Listening Port
+
+
+
+ health-check-port
+
+ health-check-port
+
+
+
+ Max Data to Receive per Second
+
+ Max Data to Receive per Second
+
+
+
+ SSL Context Service
+
+ org.apache.nifi.ssl.RestrictedSSLContextService
+ SSL Context Service
+
+
+
+ HTTP Protocols
+
+
+SSL Context Service
+
+ HTTP Protocols
+
+
+
+ client-authentication
+
+
+SSL Context Service
+
+ client-authentication
+
+
+
+ Authorized DN Pattern
+
+ Authorized DN Pattern
+
+
+
+ authorized-issuer-dn-pattern
+
+ authorized-issuer-dn-pattern
+
+
+
+ Max Unconfirmed Flowfile Time
+
+ Max Unconfirmed Flowfile Time
+
+
+
+ HTTP Headers to receive as Attributes (Regex)
+
+ HTTP Headers to receive as Attributes (Regex)
+
+
+
+ Return Code
+
+ Return Code
+
+
+
+ multipart-request-max-size
+
+ multipart-request-max-size
+
+
+
+ multipart-read-buffer-size
+
+ multipart-read-buffer-size
+
+
+
+ max-thread-pool-size
+
+ max-thread-pool-size
+
+
+
+ record-reader
+
+ org.apache.nifi.serialization.RecordReaderFactory
+ record-reader
+
+
+
+ record-writer
+
+
+record-reader
+
+ org.apache.nifi.serialization.RecordSetWriterFactory
+ record-writer
+
+
+
+ ALL
+ false
+ 10 mins
+ 30 sec
+
+
+ Base Path
+ ckanListener
+
+
+ Listening Port
+ 5061
+
+
+ health-check-port
+
+
+ Max Data to Receive per Second
+
+
+ SSL Context Service
+
+
+ HTTP Protocols
+ HTTP_1_1
+
+
+ client-authentication
+ AUTO
+
+
+ Authorized DN Pattern
+ .*
+
+
+ authorized-issuer-dn-pattern
+ .*
+
+
+ Max Unconfirmed Flowfile Time
+ 60 secs
+
+
+ HTTP Headers to receive as Attributes (Regex)
+ .*
+
+
+ Return Code
+ 200
+
+
+ multipart-request-max-size
+ 1 MB
+
+
+ multipart-read-buffer-size
+ 512 KB
+
+
+ max-thread-pool-size
+ 200
+
+
+ record-reader
+
+
+ record-writer
+
+
+ 10
+ 0
+ 0 sec
+ TIMER_DRIVEN
+ 1 sec
+
+ false
+ ListenHTTP
+
+ false
+ success
+ false
+
+ RUNNING
+
+ org.apache.nifi.processors.standard.ListenHTTP
+
+
+ cff93d35-3836-3f2e-0000-000000000000
+ a191897b-2b00-3c65-0000-000000000000
+
+ 0.0
+ 448.0
+
+
+ nifi-ngsild-ckan-nar
+ egm.io
+ 1.27.0
+
+
+ PENALIZE_FLOWFILE
+ WARN
+
+ 1
+
+
+ CKAN Host
+
+ CKAN Host
+
+
+
+ CKAN Port
+
+ CKAN Port
+
+
+
+ CKAN Viewer
+
+ CKAN Viewer
+
+
+
+ CKAN API Key
+
+ CKAN API Key
+
+
+
+ SSL
+
+ SSL
+
+
+
+ create-datastore
+
+ create-datastore
+
+
+
+ Batch Size
+
+ Batch Size
+
+
+
+ rollback-on-failure
+
+ rollback-on-failure
+
+
+
+ ALL
+ false
+ 10 mins
+ 30 sec
+
+
+ CKAN Host
+ opendata-dev.stellio.io
+
+
+ CKAN Port
+ 443
+
+
+ CKAN Viewer
+ datatables_view
+
+
+ CKAN API Key
+
+
+ SSL
+ true
+
+
+ create-datastore
+ true
+
+
+ Batch Size
+ 10
+
+
+ rollback-on-failure
+ true
+
+
+ 10
+ 0
+ 0 sec
+ TIMER_DRIVEN
+ 1 sec
+
+ false
+ NgsiLdToCkan
+
+ true
+ failure
+ false
+
+
+ true
+ retry
+ false
+
+
+ true
+ success
+ false
+
+ RUNNING
+
+ egm.io.nifi.processors.ckan.NgsiLdToCkan
+
+
+ 02/13/2025 16:09:26 GMT
+
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..35e32c6
--- /dev/null
+++ b/README.md
@@ -0,0 +1,195 @@
+# NgsiLdToCkan
+
+[](https://spdx.org/licenses/Apache-2.0.html)
+
+
+## Table of Contents
+- [Overview](#overview)
+- [Functionality](#functionality)
+ - [CKAN Data Structures And Mapping](#ckan-data-structures-and-mapping)
+ - [Input Data](#input-data)
+ - [Output](#output)
+- [Requirements](#requirements)
+- [Configuration](#configuration)
+ - [Processor Properties](#processor-properties)
+- [Metadata](#metadata)
+- [Template](#template)
+- [Limitations](#limitations)
+- [Roadmap & Issues](#roadmap--issues)
+
+## Overview
+
+`NgsiLdToCkan` is a NiFi processor that persists NGSI-LD entities within a [CKAN](https://ckan.org/) server.
+Entities are received through NGSI-LD notifications sent by a NGSI-LD Context Broker.
+
+## Functionality
+
+### CKAN Data Structures And Mapping
+
+CKAN is a powerful platform for managing and publishing collections of data. These collections are owned by organizations.
+Each organization contains multiple datasets (called packages in CKAN) and every dataset consists of several resources.
+A resource is the structure that holds the data itself. In addition, a dataset also contains metadata (information about the data).
+
+CKAN offers a generic mapping between its model and [DCAT](https://www.w3.org/TR/vocab-dcat-3/) classes like `dcat:Dataset` and `dcat:Distribution`.
+
+In this mapping, a `Dataset` entity in the Context Broker is equivalent to a dataset in CKAN, while a `Distribution` entity
+is equivalent to a resource. However, a `Catalog` entity is not directly equivalent to an organization
+because the concept of an organization in CKAN does not directly align with the concept of a `dcat:Catalog`.
+
+A more straight-forward mapping from CKAN metadata to DCAT metadata is also done.
+
+For more in-depth information about `dcat:Dataset` and `dcat:Distribution` see [Smart data models - DCAT data model](https://github.com/smart-data-models/dataModel.DCAT-AP).
+
+When creating datasets and resources in CKAN, the processor leverages the attributes in the received NGSI-LD entities to
+enrich the created datasets and resources with the metadata that it can extract from the NGSI-LD entities. One goal of this
+behavior is also to expose datasets and resources that comply with the [FAIR principles](https://www.go-fair.org/fair-principles/).
+
+### Input Data
+
+The input data must be a valid NGSI-LD notification containing the entities to be persisted in the CKAN server.
+Each entity must at leat have a `title` attribute that will be used as the name of the resource.
+A `datasetTitle` must exist as a flowfile attribute to be used as the name of the dataset belonging to the resource.
+(future versions of the processor will automatically retrieve dataset information by using the relationship between a
+`Distribution` entity and a `Dataset` entity).
+
+In addition, other metadata can also be added as flowfile attributes to be extracted by the processor.
+The `keywords` attribute however must always be present. It is a comma seperated list of terms that will be added as tags
+to the dataset (e.g., ["keyword1", "keyword2", "keyword3"]).
+
+**Example of a NGSI-LD notification received by the processor**
+
+```json
+{
+ "id": "urn:ngsi-ld:Notification:1",
+ "type": "Notification",
+ "subscriptionId": "urn:ngsi-ld:Subscription:CKAN",
+ "notifiedAt": "2025-02-10T13:29:53.903986Z",
+ "data": [
+ {
+ "id": "urn:ngsi-ld:Distribution:1",
+ "type": "Distribution",
+ "title": {
+ "type": "Property",
+ "value": "Entity example"
+ },
+ "name": {
+ "type": "Property",
+ "value": "Entity name",
+ "observedAt": "2025-02-10T10:18:20Z"
+ }
+ }
+ ]
+}
+```
+
+### Output
+
+The `NgsiLdToCkan` processor publishes all entities of the same type in the same dataset.
+Each entity is as a resource with a default `application/ld+json` format.
+
+In CKAN, names for an organization, a dataset, or a resource must only contain alphanumeric characters, `-` , or `_`.
+The length must be between 2 and 100 characters. Thus, a transformation is automatically performed by the processor.
+
+## Requirements
+
+A `Subscription` must be created to trigger the notifications sent when entities are created or updated.
+
+Since there is no direct mapping between `dcat:Catalog` and an organization in CKAN, a `X-CKAN-OrganizationName` key-value pair
+must be added to the `receiverInfo` in the `Subscription`. This value will be extracted in the processor as a flowfile
+attribute and used as the name of the organization owning the resource.
+
+```json
+{
+ "id": "urn:ngsi-ld:Subscription:CKAN",
+ "type": "Subscription",
+ "entities": [
+ {
+ "type": "Distribution"
+ }
+ ],
+ "notificationTrigger": [
+ "entityCreated",
+ "entityUpdated"
+ ],
+ "notification": {
+ "format": "normalized",
+ "endpoint": {
+ "uri": "http://localhost:8080/ckanListener",
+ "accept": "application/json",
+ "receiverInfo": [
+ {
+ "key": "X-CKAN-OrganizationName",
+ "value": "Organization Name"
+ }
+ ]
+ }
+ }
+}
+```
+
+## Configuration
+
+### Processor Properties
+
+
+
+* `CKAN Viewer` property specifies the visualization of the resource data on the CKAN resource page.
+
+* `CKAN API Key` property is a token generated from the user account on the CKAN site.
+
+* `Create DataStore` property creates the resource in the datastore when set to true.
+
+## Metadata
+
+Metadata treated by the processor and added in the CKAN server can be mapped to DCAT metadata. The following tables provide a list of metadata the processor extracts
+as flowfile attributes and its equivalent in `dcat:Dataset` and `dcat:Distribution`.
+
+
+| CKAN Metadata for datasets | Equivalent in `dcat:Dataset` | flowfile attribute name in `NgsiLdToCkan` processor |
+|----------------------------|------------------------------|-----------------------------------------------------|
+| notes | description | packageDescription |
+| version | version | version |
+| url | landingPage | landingPage |
+| visibility | - | visibility |
+| Publisher_type | isPublishedBy | organizationType |
+| contact_uri | contactPoint | contactPoint |
+| contact_name | - | contactName |
+| contact_email | - | contactEmail |
+| spatial_uri | - | spatialUri |
+| spatial | spatial | spatialCoverage |
+| temporal_start | - | temporalStart |
+| temporal_end | - | temporalEnd |
+| theme | theme | themes |
+| access_rights | accessRights | datasetRights |
+| tags | keyword | keywords |
+
+
+| CKAN Metadata for resources | Equivalent in `dcat:Distribution` | flowfile attribute name in `NgsiLdToCkan` processor |
+|-----------------------------|-----------------------------------|-----------------------------------------------------|
+| access_url | accessURL | accessURL |
+| availability | availability | availability |
+| description | description | resourceDescription |
+| mimetype | mediaType | mimeType |
+| download_url | downloadURL | downloadURL |
+| size | byteSize | byteSize |
+| rights | rights | resourceRights |
+| license | license | license |
+| license_type | - | licenseType |
+
+
+## Template
+
+A basic NiFi template with the `NgsiLdToCkan` processor can be found [here](CKAN_User_Guide_Template.xml).
+
+## Current limitations
+
+* The processor does not support multi-attributes instances.
+* The processor only supports attributes of type `Property`, `Relationship` and `GeoProperty`.
+* An already existing resource can't be updated with new attributes.
+* There's no description for datasets.
+* Not all DCAT metadata available in a dataset is utilized (for example `publisher` metadata which can be used when creating an organization)
+* Metadata and dataset title must be added as flowfile attributes instead of being extracted inside the processor (this can be avoided with the use of NGSI-LD Linked Entity Retrieval).
+
+## Roadmap & Issues
+
+To check out planned features, report bugs or suggest new features see [open issues](https://github.com/easy-global-market/nifi-ngsild-ckan/issues).
diff --git a/docs/images/Ckan config.png b/docs/images/Ckan config.png
new file mode 100644
index 0000000..f2ebbd1
Binary files /dev/null and b/docs/images/Ckan config.png differ
+
+* `CKAN Viewer` property specifies the visualization of the resource data on the CKAN resource page.
+
+* `CKAN API Key` property is a token generated from the user account on the CKAN site.
+
+* `Create DataStore` property creates the resource in the datastore when set to true.
+
+## Metadata
+
+Metadata treated by the processor and added in the CKAN server can be mapped to DCAT metadata. The following tables provide a list of metadata the processor extracts
+as flowfile attributes and its equivalent in `dcat:Dataset` and `dcat:Distribution`.
+
+
+| CKAN Metadata for datasets | Equivalent in `dcat:Dataset` | flowfile attribute name in `NgsiLdToCkan` processor |
+|----------------------------|------------------------------|-----------------------------------------------------|
+| notes | description | packageDescription |
+| version | version | version |
+| url | landingPage | landingPage |
+| visibility | - | visibility |
+| Publisher_type | isPublishedBy | organizationType |
+| contact_uri | contactPoint | contactPoint |
+| contact_name | - | contactName |
+| contact_email | - | contactEmail |
+| spatial_uri | - | spatialUri |
+| spatial | spatial | spatialCoverage |
+| temporal_start | - | temporalStart |
+| temporal_end | - | temporalEnd |
+| theme | theme | themes |
+| access_rights | accessRights | datasetRights |
+| tags | keyword | keywords |
+
+
+| CKAN Metadata for resources | Equivalent in `dcat:Distribution` | flowfile attribute name in `NgsiLdToCkan` processor |
+|-----------------------------|-----------------------------------|-----------------------------------------------------|
+| access_url | accessURL | accessURL |
+| availability | availability | availability |
+| description | description | resourceDescription |
+| mimetype | mediaType | mimeType |
+| download_url | downloadURL | downloadURL |
+| size | byteSize | byteSize |
+| rights | rights | resourceRights |
+| license | license | license |
+| license_type | - | licenseType |
+
+
+## Template
+
+A basic NiFi template with the `NgsiLdToCkan` processor can be found [here](CKAN_User_Guide_Template.xml).
+
+## Current limitations
+
+* The processor does not support multi-attributes instances.
+* The processor only supports attributes of type `Property`, `Relationship` and `GeoProperty`.
+* An already existing resource can't be updated with new attributes.
+* There's no description for datasets.
+* Not all DCAT metadata available in a dataset is utilized (for example `publisher` metadata which can be used when creating an organization)
+* Metadata and dataset title must be added as flowfile attributes instead of being extracted inside the processor (this can be avoided with the use of NGSI-LD Linked Entity Retrieval).
+
+## Roadmap & Issues
+
+To check out planned features, report bugs or suggest new features see [open issues](https://github.com/easy-global-market/nifi-ngsild-ckan/issues).
diff --git a/docs/images/Ckan config.png b/docs/images/Ckan config.png
new file mode 100644
index 0000000..f2ebbd1
Binary files /dev/null and b/docs/images/Ckan config.png differ