# V13 and "hcm.properties" file location

**URL:** <https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969>\
**Category:** Experience Manager (PaaS/OnPrem)\
**Created:** [April 11, 2019, 8:31am UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969 "2019-04-11T08:31:20Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![bkurent](https://avatars.discourse-cdn.com/v4/letter/b/8491ac/32.png) [@bkurent](https://community.bloomreach.com/u/bkurent)\
**Post date:** [April 11, 2019, 8:31am UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/1 "2019-04-11T08:31:21Z")

</div>

Hi,

We have separate deployment of authoring and delivery applications. We just upgraded from 12.4 to 13.1 version and using single site mode. I have a problem with deploying platform (ex. repository.war) application on delivery server. The error I get is:

> 10.04.2019 16:06:12 [localhost-startStop-1] INFO [org.hippoecm.repository.security.SecurityManager.configure():133] Security provider ‘internal’ initialized.  
> 10.04.2019 16:06:24 [localhost-startStop-1] ERROR [org.onehippo.cm.engine.ConfigurationServiceImpl.serviceRegistered():1020] Failed to read hcm-site.yaml  
> java.io.FileNotFoundException: META-INF/hcm-site.yaml  
> at org.onehippo.cm.engine.ConfigurationServiceImpl.serviceRegistered(ConfigurationServiceImpl.java:1015) [hippo-repository-engine-13.1.0.jar:13.1.0]  
> at org.onehippo.cms7.services.WhiteboardServiceRegistry.register(WhiteboardServiceRegistry.java:107) [hippo-services-13.1.0.jar:13.1.0]

It looks like the plaftorm app expects “hcm-site.yaml”, necessary for Multi Site mode. But we are using Single site mode. Only guessing, but could this be because “hcm.properties” is in /cms module and not in /site module? Also documentation seems to be little unclear about this:

1. 

> **[Comparing Single Delivery Webapp Mode and Multi Delivery Webapp Mode -...](https://xmdocumentation.bloomreach.com/library/concepts/multiple-site-web-applications/single-vs-multi-site-mode.html)**
>
> The fast and flexible on-premise or PaaS headless CMS

> HCM sites support disabled through use.hcm.sites flag in hcm.properties file in src/main/resources folder of the **site** module

1. 

> **[Single Delivery Web Application Mode - Bloomreach Experience Manager...](https://xmdocumentation.bloomreach.com/library/concepts/multiple-site-web-applications/single-site-mode.html)**
>
> The fast and flexible on-premise or PaaS headless CMS

> There is a **cms** /src/main/resources/hcm.properties file setting use.hcm.sites to false

Any ideas?

Thanks!

---

<div class="post-metadata">

**Author:** ![machak](https://yyz1.discourse-cdn.com/flex027/user_avatar/community.bloomreach.com/machak/32/1298_2.png) [@machak](https://community.bloomreach.com/u/machak)\
**Post date:** [April 11, 2019, 8:55am UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/2 "2019-04-11T08:55:04Z")

</div>

I think it is caused by you bootstrapping, so, should disable bootstrapping on that node.

---

<div class="post-metadata">

**Author:** ![bkurent](https://avatars.discourse-cdn.com/v4/letter/b/8491ac/32.png) [@bkurent](https://community.bloomreach.com/u/bkurent)\
**Post date:** [April 11, 2019, 9:03am UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/3 "2019-04-11T09:03:38Z")

</div>

Bootstrapping is on false, same as in our (working) 12.4 version app.

---

<div class="post-metadata">

**Author:** ![Lef\_Karamoulas](https://yyz1.discourse-cdn.com/flex027/user_avatar/community.bloomreach.com/lef_karamoulas/32/82_2.png) [@Lef\_Karamoulas](https://community.bloomreach.com/u/Lef_Karamoulas)\
**Post date:** [April 11, 2019, 9:04am UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/4 "2019-04-11T09:04:38Z")

</div>

Hello,

I would say that your observations are correct and page [1] should be updated.

Could you validate that your resources are included in your cms module build ?

HTH

---

<div class="post-metadata">

**Author:** ![bkurent](https://avatars.discourse-cdn.com/v4/letter/b/8491ac/32.png) [@bkurent](https://community.bloomreach.com/u/bkurent)\
**Post date:** [April 11, 2019, 10:36am UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/5 "2019-04-11T10:36:14Z")

</div>

I checked cms.war artifact on authoring server and it contains “hcm.properties” file. But the problem for me is delivery server and platform.war app error on startup “java.io.FileNotFoundException: META-INF/hcm-site.yaml”. This file should not be necessary, since we are in Single Site mode.

---

<div class="post-metadata">

**Author:** ![Lef\_Karamoulas](https://yyz1.discourse-cdn.com/flex027/user_avatar/community.bloomreach.com/lef_karamoulas/32/82_2.png) [@Lef\_Karamoulas](https://community.bloomreach.com/u/Lef_Karamoulas)\
**Post date:** [April 11, 2019, 12:38pm UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/6 "2019-04-11T12:38:23Z")

</div>

My next suggestion would be to go through the dependencies for all the related modules.

The upgrade steps to v13 as well the separate distributions setup include plenty additions/removals with regards dependencies. Just to make sure that you are not pulling any unnecessary dependencies in your delivery nodes.

Kind regards

---

<div class="post-metadata">

**Author:** ![mdrenthe](https://yyz1.discourse-cdn.com/flex027/user_avatar/community.bloomreach.com/mdrenthe/32/303_2.png) [@mdrenthe](https://community.bloomreach.com/u/mdrenthe)\
**Post date:** [April 16, 2019, 2:53pm UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/7 "2019-04-16T14:53:46Z")

</div>

Run into the same problem as the author of this topic:

While not running it on separate author and delivery it seems not to pick up the:  
‘cms/src/main/resources/hcm.properties’  
containing: use.hcm.sites=false

When applied use.hcm.sites as system property setenv.sh/bat or within cargo.run  
\< systemProperties \>  
\< use.hcm.sites\>false\</use.hcm.sites\>  
\< /systemProperties \>

Then it will work for me

---

<div class="post-metadata">

**Author:** ![bkurent](https://avatars.discourse-cdn.com/v4/letter/b/8491ac/32.png) [@bkurent](https://community.bloomreach.com/u/bkurent)\
**Post date:** [June 13, 2019, 1:31pm UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/8 "2019-06-13T13:31:00Z")

</div>

Same solution also worked for me! FileNotFoundException went away! Thanks!

---

<div class="post-metadata">

**Author:** ![Ilakkia\_Baskar](https://yyz1.discourse-cdn.com/flex027/user_avatar/community.bloomreach.com/ilakkia_baskar/32/2044_2.png) [@Ilakkia\_Baskar](https://community.bloomreach.com/u/Ilakkia_Baskar)\
**Post date:** [July 1, 2025, 3:38pm UTC](https://community.bloomreach.com/t/v13-and-hcm-properties-file-location/969/9 "2025-07-01T15:38:13Z")

</div>

Hello @bkurent ,

We are happy you are part of Bloomreach Developer’s Community.  
Thank you for reaching out to us.

We hope we have answered your queries and therefore marking this thread for Closure.  
We are delighted to acknowledge your ongoing contributions to our esteemed Bloomreach Community.

Best Regards,  
Bloomreach
