[App Request]: Beszel agent

[jondycz]

App Name

Beszel agent

App Description

Simple, lightweight server monitoring with Docker stats, historical data, and alerts.

App Website / Github Repo

https://github.com/henrygd/beszel

Docker Installation Documentation

https://beszel.dev/guide/getting-started

App Icon URL

https://raw.githubusercontent.com/henrygd/beszel/refs/heads/main/internal/site/public/static/icon.svg

Docker Image

ghcr.io/henrygd/beszel-agent

App Category

Monitoring

Requirements Checklist

• The app is actively maintained
• The app has official Docker images available
• The app has versioned image tags available
• The app is open source or has a free tier
• I have tested the Docker installation locally

Additional Information

App consists of dashboard and daemon.

When daemon and dashboard are both installed in the same compose file, these two components talk through a socket file.

When installed separately, they need exposed ports for http communication.

I'd love to see a hybrid approach. Allowing users to run Beszel in dashboard mode, daemon mode, full stack mode. When in full stack mode, the compose renders as shown in docs. When in other modes, then it runs either one or the other container with exposed ports to be integrated with external dashboard/daemons.

[stavros-k]

Server part is already in the catalog.. :)

[jondycz]

Server part is already in the catalog.. :)

Interesting. I searched the issues whether it was requested and it wasn't. Must have been added without an open issue. 😅

Sooo. Do you think it's possible to extend the functionality of the existing app? I could make a drop-down and wire the two containers together. Though I've got no clue how to do migrations.

IMHO, when an install type is selected (dashboard only, bundled etc...) the selectbox should be locked down and changing it should require app reinstall.

[stavros-k]

I believe it is better to have it as separate app.
So users that want just the agent (ie have a server elsewhere) can install it.!

[jondycz]

I believe it is better to have it as separate app. So users that want just the agent (ie have a server elsewhere) can install it.!

Yeah, that's why I proposed users could select to only install the agent, or only install the dashboard. Or both preconfigured.

It's making the YAML template a bit more advanced but nothing too extra. And bundled in a single compose file is the default based on the docs. As that monitors the machine it's running on while still allowing to monitor other systems.

If bundled option was added, then running it in agent mode only is the simplest thing to add, so why not also have that as an option.

But if you believe having it separate is the only correct thing to do, you can close the issue.

[stavros-k]

Having them on a single will need to remove the host network option, which might be needed for the agent to gather more info on the host.
You can add the agent as a standalone app, merging it will close this issue too :)

[jondycz]

Having them on a single will need to remove the host network option, which might be needed for the agent to gather more info on the host. You can add the agent as a standalone app, merging it will close this issue too :)

That is a valid point I didn't think of.