# Ouro Butler

Ouro Butler is a friendly Telegram steward for an Unraid household that turns system evidence into useful agent-managed help, keeps each family member private, and asks before consequential actions. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3168/ouro-butler

## Description

Ouro Butler is a friendly Telegram steward for an Unraid household that turns system evidence into useful agent-managed help, keeps each family member private, and asks before consequential actions.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

59/100 (Fair), based on 3 of 4 factors.
- Maintained: 100 (last commit 0 days ago)
- Popular: 12 (3 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/ouro-butler-18i2cup02f5mud?q=ouro-butler
- Official website: https://ouroboros.bot
- GitHub: https://github.com/ourostack/ouroboros
- Documentation: https://ouroboros.bot/docs

## Common questions

### How do I install Ouro Butler on Unraid?

Find ouro-butler in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

### How do I start the Ouroboros daemon in production mode?

Run ouro up. It starts the daemon from the installed production version, syncs the launcher, installs workflow helpers, and reconciles stale runtime state.

### Where are credentials and durable agent state stored?

Raw credentials live in the owning agent's Bitwarden or Vaultwarden vault, while vault coordinates and local runtime state live in the agent bundle. Agent bundles are stored at ~/AgentBundles/.ouro/, and machine-scoped harness state is under ~/.ouro-cli.

### Which communication senses are built into the harness?

The first-class senses are cli, teams, bluebubbles, mail, and voice. MCP is a bridge for developer tools and is described as a separate channel rather than a sense.

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