Help › Start here
bananana on Unraid
Install the brain and the agent from Unraid's Apps tab: where the token and code go, what each setting does, updating, and common problems.
Both halves of bananana.dev are in Community Applications: bananana-brain, your dashboard, and bananana-node, the agent that connects the Unraid server to a brain. Neither opens a port. You need Unraid 6.12 or newer with the Apps tab (the Community Applications plugin), and internet access.
Install the brain
- Go to bananana.dev/start and create a free account. Answer the questions and name your brain.
- At Where will you run your brain? choose Unraid and press Continue. The next page shows your setup token, which starts with
bst_. Press Copy and leave the page open. - In Unraid, open Apps, search for bananana and install bananana-brain.
- Paste the token into Setup token and press Apply.
- Go back to the setup page. It moves on by itself when the brain connects, usually within a minute, and then takes you to your brain at your-name.bananana.dev.
The token works once and expires after 24 hours. If it expired, press New token on the setup page.
The brain's settings
| Setting | Default | What it does |
|---|---|---|
| Data | /mnt/user/appdata/bananana-brain | The brain's identity, settings, users and history. Keep it backed up. |
| Setup token | empty | The bst_ token from the setup page. It's used on the first start only, and ignored after that. |
| Backups | empty | Under Show more settings. Optional: where the nightly backup goes, for example a share on the array. Without it, backups stay in backups inside Data. |
There's no port to set and no WebUI to open: you reach the brain at your-name.bananana.dev and in the bananana.dev apps.
Install the agent
The agent lets the brain see and manage this Unraid server. If the brain runs here too, you still install the agent: the brain container can't see the server around it.
- On your brain, open Nodes and press Onboard a device.
- Choose Install command, give it a name, and pick Unraid under System. Choose its features and press Create install code.
- Press Copy to copy the code. It starts with
bnn-. - In Unraid, open Apps, install bananana-node and paste the code into Code. Press Apply.
- Watch the brain's page change to Connected.
The code works once and expires after 24 hours. Treat it like a password until it's used.
The agent's settings
| Setting | Default | What it does |
|---|---|---|
| Data | /mnt/user/appdata/bananana-node | The agent's identity and settings. Its private key stays here. |
| Code | empty | The bnn- code from your brain. A remote code or deployment key works here too. It's used on the first start only. |
| Name | empty | Under Show more settings. Optional: the name shown on the brain. Without it, the name you gave the code is used, or the server's name. |
Why the agent is privileged
The template turns on Privileged, the host network, and --pid=host --uts=host. The agent reports and manages the server itself, not just its own container, and each of these is part of that:
| Setting | Why it's needed |
|---|---|
| Privileged | Reads disks and temperature sensors, and runs host commands such as docker and the terminal's shell. |
Host processes (--pid=host) | Shows the server's processes, and reaches its files. |
| Host network | Reports the server's real network interfaces and traffic, and lets it join your bunch. |
Host name (--uts=host) | Reports the server's real name. |
Those settings are what the container can reach. What the agent may do (terminal, files, service control) is what you chose when you created the code, and the agent enforces it. Screen control isn't available in the container. The brain doesn't need any of this: it isn't privileged.
Updating
- The brain: Unraid shows apply update next to bananana-brain on the Docker tab when a new image is out. Your data stays in Data.
- The agent: it updates itself like any other node.
Common problems
The setup page keeps waiting for the brain
On the Docker tab, click the bananana-brain icon and choose Logs. setup didn't finish gives the reason. If the token expired or was already used, press New token on the setup page, then click the icon, choose Edit, paste it into Setup token and press Apply. not connected to a bananana.dev account yet means Setup token is empty.
There's no Unraid choice under System
Your brain is an older version: update it. Until then, pick Docker and copy the part of the command between the quotes that starts with bnn-. That's the same code.
The node never connects
Open the bananana-node Logs. If the code expired or was used, create a new one on the brain, then Edit the container, paste it into Code and press Apply.
The node is connected but says it's waiting
A remote code or deployment key can need your approval: Approving devices.
Removing them
On the Docker tab, click the icon and choose Remove. Then delete the app's folder under /mnt/user/appdata only if you also want to delete its data. After removing the agent, press Remove on the device's page on the brain.