Beszel Companion is an unofficial, native iOS client for the Beszel server monitoring platform.
This application allows you to view your server and container statistics directly from your iPhone by connecting to your Beszel instance's API.
Important
A working Beszel instance accessible from the internet is required to use Beszel Companion.
By default, only an admin user can read all data. For better security, you can create a readonly user by modifying API route access in your PocketBase settings.
Note
You can log in to your instance via the SSO configured on Beszel.
Please note that you will need to add beszel-companion://redirect to the redirect_uris of your SSO providers.
| Home | System | Containers | Detail View |
|---|---|---|---|
 |
 |
 |
 |
- System stats: Charts for CPU, memory, swap, disk, network, load average, temperatures, GPU, and battery.
- Container stats: Browse Docker containers with CPU, memory, network usage, and logs.
- Custom dashboard: Pin your favorite charts with search and flexible sorting for quick access.
- Alerts & notifications: Push notifications for system status, with configurable thresholds for CPU, memory, temperature, load average, battery, and GPU.
- Widgets: Home Screen and Lock Screen widgets for glanceable stats.
- Multiple hub management: Manage and switch between multiple Beszel hubs and their associated systems.
- Secure connections: mTLS with client certificates, SSO / OAuth, 2FA, and credentials stored in the iOS Keychain.
- Polished experience: Face ID / passcode lock and theme support.
- Localization: Available in English, French, and Polish. Contribute on Crowdin.
Tip
Looking for macOS? Check out BeszelBar, a native macOS menu bar client for Beszel.
- SwiftUI: For the entire declarative and reactive user interface.
- Swift Charts: For creating all charts within the application.
- Swift Concurrency (
async/await): For modern and performant network calls. - WidgetKit: To display information on the Home Screen.
- Security: For Keychain storage and mTLS client certificate management.
- Sideload the
.ipafrom releases
The Home Screen widgets will not function if you install the app by sideloading the .ipa file. This is a known limitation due to iOS security policies, as sideloading prevents the widget from securely sharing data and credentials with the main app through the required App Group.
For the best experience, including widget support, please download the official version from the App Store.
Some SSO providers, like Google, have security policies that do not support custom URL schemes for redirects. This means that authentication through these providers will not work unless the Beszel API is updated to support a https redirect endpoint for mobile clients.
A huge thank you to henrygd for creating Beszel, a fantastic, lightweight, and open-source monitoring tool. This mobile client would not exist without his remarkable work.
This project is distributed under the MIT License. See the LICENSE file for more details.
