Webmin
Webmin
This integrationIntegrations connect and integrate Home Assistant with your devices, services, and more. [Learn more] provides sensors for monitoring the CPU and memory usage of your server.
Prerequisites
Authentication setup
Always consider your own setup and security needs before exposing services with system-level access.
As a good security practice, create a Webmin User specific to Home Assistant. A dedicated account allows for this integration to operate uninterrupted should you change your primary login for Webmin, and it can allow for more granular access so that only the necessary data and access is made available to Home Assistant.
Suggested User Setup
- Create the account with a strong password,
- Only enable the “Can accept RPC calls” permission (under “Permissions for all modules”),
- Consider disabling the “Can accept RPC calls” permission for other users (unless specifically required),
- Consider limiting this account to only have access via the IP address of your Home Assistant instance (if appropriate).
The Webmin API ignores any 2FA set up via the frontend. Even with 2FA enabled, it is still possible to use the API with only a username and password.
Required Webmin Perl Module
Ensure the XML::Parser
Perl module is installed via Webmin Perl Modules
Installing XML::Parser Perl Module
- In the Webmin UI, go to Tools > Perl Modules.
- Under the Install module tab, enter
XML::Parser
into the From CPAN text field. - Select Install at the bottom of the dialog.
- Confirm that the installation is successful.
- If the installation succeeds:
- Continue with any remaining steps for Home Assistant.
- If the installation fails:
- Refer to Webmin documentation for Perl Modules
to resolve any Webmin issues. - Retry the module installation and confirm that
XML::Parser
is listed on the Perl Modules page under Existing Modules.
- Refer to Webmin documentation for Perl Modules
- If the installation succeeds:
Configuration
To add the Webmin device to your Home Assistant instance, use this My button:
Manual configuration steps
If the above My button doesn’t work, you can also perform the following steps manually:
-
Browse to your Home Assistant instance.
-
In the bottom right corner, select the
Add Integration button. -
From the list, select Webmin.
-
Follow the instructions on screen to complete the setup.
Sensors
All entities are disabled by default. You must enable any entities that you wish to use.
The following sensors are provided:
- Load (1m)
- Load (5m)
- Load (15m)
- Memory total
- Memory free
- Swap total
- Swap free
- Total space for all disks
- Free space for all disks
- Used space for all disks
- For each filesystem mountpoint:
- Used space
- Free space
- Total space
- Used inodes
- Free inodes
- Total inodes
- Disk usage in percent
- Inode usage in percent