> For the complete documentation index, see [llms.txt](https://docs.bonzai.sh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bonzai.sh/product-manuals/bonzai-desktop/settings-troubleshooting.md).

# Settings & Troubleshooting

## Model storage

Use model controls to see what is installed, download a missing model, or remove a model you no longer use. Completed downloads should change to Ready automatically.

## Theme and display

Choose the light or dark theme and use full-screen modes where available. Interface controls should remain usable at normal desktop scaling; report clipping with the affected view and display scaling.

## Network settings

The network control at the bottom of the sidebar opens peer-to-peer mode, provider, wallet, payment, and appearance settings. Review the network, amount, recipient, and permission before signing any transaction.

## Server status

BonzAI starts local AI services with the app. Status notifications show starting, ready, crashed, and restarting states. Automatic recovery uses limited retries rather than restarting forever.

## Quick recovery checklist

1. Let the current download or generation finish.
2. Retry the operation once.
3. Choose a smaller model or lower resolution.
4. Close memory-heavy applications.
5. Restart BonzAI Desktop.
6. Confirm enough free disk space remains.
7. Open diagnostics and record the exact error if it repeats.

## Keep data safe

Export important contribution packs, companion identities, memories, and generated work before removing local data or moving to another computer.