---
title: 'vCloud: "Failed to Start" after changing "Public Addresses" for API'
url: 'https://patrik.kernstock.net/blog/vcloud-failed-to-start-after-changing-public-addresses-for-api'
markdown: 'https://patrik.kernstock.net/blog/vcloud-failed-to-start-after-changing-public-addresses-for-api.md'
date: '2021-12-27'
description: 'This is one post of category "QuickTip" and "Lesson learned"… So I was getting hands on VMware vCloud in my HomeLab and admins who have gone through the administrative-side might know the Public Addresses functionality (see docs). However to note: Don’t ever think of changing the API-part to someth…'
taxonomy:
  category:
    - VMware
  tag:
    - QuickTip
    - vCloud
---

# [vCloud: "Failed to Start" after changing "Public Addresses" for API](https://patrik.kernstock.net/blog/vcloud-failed-to-start-after-changing-public-addresses-for-api)

   December 27, 2021    1 min 

   [VMware](https://patrik.kernstock.net/category:VMware)    [QuickTip](https://patrik.kernstock.net/tag:QuickTip) [vCloud](https://patrik.kernstock.net/tag:vCloud)  

 Note

This article is more than 4 year(s) old – information may be outdated.

 ![vCloud: "Failed to Start" after changing "Public Addresses" for API](https://patrik.kernstock.net/images/2/0/2/1/-/2021-12-2519-46-27-bfo9uyw7-5fd0209b.png?g-b3a1b014 "vCloud: "Failed to Start" after changing "Public Addresses" for API") 

This is one post of category "QuickTip" and "Lesson learned"… So I was getting hands on VMware vCloud in my HomeLab and admins who have gone through the administrative-side might know the `Public Addresses` functionality ([see docs](https://docs.vmware.com/en/VMware-Cloud-Director/10.3/VMware-Cloud-Director-Install-Configure-Upgrade-Guide/GUID-332C9051-5072-45B3-8B0D-6B69D2BC3A7C.html)).

However to note: Don’t ever think of changing the API-part to something like `https://vcd.domain.tld/api`, as things go south:

[![vCloud: "Public Addresses"](https://patrik.kernstock.net/images/2/0/2/1/-/2021-12-2714-48-06-0spwqlkw-92f31666.png?g-b3a1b014)](https://patrik.kernstock.net/user/pages/01.blog/2021-12-27-vcloud-failed-to-start-after-changing-public-addresses-for-api/2021-12-27_14-48-06-0sPwqLkW.png?g-b3a1b014)

If set, API requests go to `https://vcd.domain.tld/api/api`, making the API requests fail with `404 - Not found`, rendering the Web UI unuseable and constantly failing with `Failed to Start`:

[![vCloud: "Failed to Start"](https://patrik.kernstock.net/images/2/0/2/1/-/2021-12-2519-51-24-cs98issz-fd0318b1.png?g-b3a1b014)](https://patrik.kernstock.net/user/pages/01.blog/2021-12-27-vcloud-failed-to-start-after-changing-public-addresses-for-api/2021-12-25_19-51-24-cS98isSz.png?g-b3a1b014)

As the Web UI was not available, I couldn’t change the setting back to revive the Web UI. After some investigation however, I found a way working around this specific issue without re-deploying or restoring a backup.

On the vCloud Linux appliance there is a `cell-management` utility, allowing you to change various settings via CLI.

**To retrieve the current REST-API settings:**

```shell
root@vcd [ ~ ]# /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n restapi.baseUri -l
Property "restapi.baseUri" has value "https://vcd.domain.tld/api"

root@vcd [ ~ ]# /opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n restapi.baseHttpUri -l
Property "restapi.baseHttpUri" has value "http://vcd.domain.tld/api"
```

**With the same utility the same configuration options can be adjusted:**

```shell
/opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n restapi.baseUri -v "https://vcd.domain.tld"
/opt/vmware/vcloud-director/bin/cell-management-tool manage-config -n restapi.baseHttpUri -v "https://vcd.domain.tld"
```

Now the vCloud Web UI is accessible again and lesson learned.

##     Comments    

 Sort by: 

Loading comments...

---

## Navigation

- Parent: [Blog](https://patrik.kernstock.net/index.md)
- Previous: [QuickTip: Disable cpu-microcode from loading on ESXi](https://patrik.kernstock.net/blog/quicktip-disable-cpu-microcode-from-loading-on-esxi.md)
- Next: [QuickTip: Utilize TPS (Transparent Page Sharing) on ESXi to noticeable save memory](https://patrik.kernstock.net/blog/quicktip-utilize-tps-transparent-page-sharing-on-esxi-to-noticeable-save-memory.md)