# TeddyCloud

TeddyCloud is a self-hosted alternative server for Toniebox that lets owners host figurine audio files locally and control which data is sent to the manufacturer's cloud. It is open source and self-hosted, installable on Unraid and Proxmox.

Canonical page: https://ourlocalhost.com/app/3381/teddycloud

## Description

TeddyCloud is a self-hosted alternative server for Toniebox that lets owners host figurine audio files locally and control which data is sent to the manufacturer's cloud.

## Platform availability

Available on 2 of 10 platforms: Unraid, Proxmox.

## Health score

62/100 (Good), based on 4 of 5 factors.
- Maintained: 79 (last commit 9 days ago)
- Popular: 32 (40 GitHub stars)
- Easy to install: 45 (2 install platforms, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- GitHub: https://github.com/mrueg/addon-teddycloud
- Unraid: https://ca.unraid.net/apps/teddycloud-1bchil817ki0fc?q=teddycloud
- Proxmox: https://community-scripts.github.io/ProxmoxVE/scripts?id=teddycloud

## Common questions

### Why does TeddyCloud require port 443 for the Toniebox connection?

TeddyCloud exposes the API that the Toniebox accesses on port 443. If Home Assistant or a reverse proxy already uses that port, you need to change that port to another one.

### Where are TeddyCloud certificates, configuration, and data stored in the Home Assistant add-on?

Certificates are stored under /config/teddycloud/certs, configuration under /config/teddycloud/config, and data under /data/. You can retrieve these files by downloading a Home Assistant backup.

### Which local address should I open for TeddyCloud after a Docker Compose first run?

Open local port 8080 in your browser after starting the stack, or use port 8443 or 8444 if Docker runs without root access. Keep the generated run folder and server certificates so restarts reuse the same identity.

### What MQTT topic pattern should I use when controlling TeddyCloud boxes?

Use the exact topic pattern teddyCloud/box/<box common name>/... so commands reach the right device. A wrong topic or box name makes the app ignore the message.

### How can I visualize Toniebox state in a Home Assistant dashboard?

Enable MQTT in TeddyCloud settings with your MQTT broker, credentials, and a topic prefix. After a successful connection, TeddyCloud Server and Toniebox devices appear, and you can use their sensors in dashboard cards.

---
Source: Our Local Host (https://ourlocalhost.com/app/3381/teddycloud), the self-hosted and open-source app directory.
