Setup for regular add-on (Home Assistant Supervised) #

1. Open Home Assistant menu on the left side (sidebar) and click on your HA account name (at bottom of menu, bellow “Notifications”)

2. Click on “Security” tab

3. Scroll to bottom to “Long-lived access token” and click “CREATE TOKEN”

4. Type some name (e.g. Klet3D token) and click “OK”

5. Copy displayed token.
NOTE: you must copy it now because you will not be able to access it later

6. Go to Settings -> Add-ons -> click “GLAMOS Klet3D”

7. Go to “Configuration” tab (1).

8. Paste token you copied earlier to “Token” field (2).

9. Go to Klet3D app (https://app.klet3d.com) and open floorplan you’ve created.
From left panel copy floorplan ID and paste it on “floorplanID” field in HA (step 3 of image above).
Also, from left panel copy Licence key and paste it on “licenceKey” field in HA (step 4 of image above).

11. Click “SAVE”. (5)

12. Go back to add-on “Info” tab and click “START”.

13. When add-on started, click “OPEN WEB UI”.

14. It should display a 3D view of your home. 🏠

Setup for container version of add-on (Home Assistant Container on e.g. Docker, Proxmox…) #

1. Make sure that you have dowloaded files from Github repository. Steps to do that find on previous step of instruction LINK

2. Open “docker-compose.yml” file which you’ve downloaded. You will need to edit parameters inside.

3. First update “FLOORPLAN_ID” and “LICENSE_KEY”.
Go to Klet3D app (https://app.klet3d.com) and open floorplan you’ve created.
From left panel copy floorplan ID (number 3 on image bellow) and paste it on “FLOORPLAN_ID” field in “docker-compose.yml” file you’ve opened.
Also, from left panel copy Licence key (number 4 on image bellow) and paste it on “LICENSE_KEY” field in “docker-compose.yml” file you’ve opened.

4. Open Home Assistant menu on the left side (sidebar) and click on your HA account name (at bottom of menu, bellow “Notifications”)

5. Click on “Security” tab

6. Scroll to bottom to “Long-lived access token” and click “CREATE TOKEN”

7. Type some name (e.g. Klet3D token) and click “OK”

8. Copy displayed token.
NOTE: you must copy it now because you will not be able to access it later.

Paste token on “TOKEN” field in “docker-compose.yml” file you’ve opened.

9. Now you need to write your Home Assistant URL to “HA_URL” field in “docker-compose.yml” file.

10. NOTE: By default Klet3D add-on will be accessible on URL: http://localhost:8080/
If you want to change port 8080 to some other value, edit “ports” field of “docker-compose.yml” file.
Example: If you want to set it on port 9091, change value “8080:8099” to value “9091:8099”. After this add-on will be accessible on URL: http://localhost:9091/

11. SAVE changes in “docker-compose.yml” file.
Image bellow shows you EXAMPLE of one final “docker-compose.yml” file.

12. Run the following CLI command to build and start the container in detached mode:

docker-compose up –build -d

13. In browser open URL mentioned in step 10 (e.g. http://localhost:8080/).
It should display a 3D view of your home. 🏠