Git Product home page Git Product logo

homeassistant-truenas's Introduction

TrueNAS Integration

GitHub release (latest by date) hacs_badge Project Stage GitHub all releases

GitHub commits since latest release GitHub commit activity GitHub Workflow Status

Help localize

English Portuguese

Truenas Logo

Monitor and control your TrueNAS CORE/SCALE device from Home Assistant.

  • Monitor System (Cpu, Load, Memory, Temperature, Network, ARC/L2ARC, Uptime)
  • Monitor Disks
  • Monitor Pools (including boot-pool)
  • Monitor Datasets
  • Monitor Replication Tasks
  • Monitor Snapshot Tasks
  • Control and Monitor Services
  • Control and Monitor Virtual Machines
  • Control and Monitor Jails (TrueNAS CORE only)
  • Control and Monitor Cloudsync
  • Create a Dataset Snapshot
  • Update Sensor
  • Reboot and Shutdown TrueNAS system

Features

Pools

Monitor status for each TrueNAS pool.

Pools Health Pools Free Space

Datasets

Monitor usage and attributes for each TrueNAS dataset.

Datasets

Disks

Monitor temperature and attributes for each TrueNAS disk.

Disks

Virtual Machines

Control and monitor status and attributes for each TrueNAS Virtual Machines. Virtual Machines control is available through services.

Virtual Machines

Jails

TrueNAS CORE only

Control and monitor status and attributes for each TrueNAS jail. Jail control is available through services.

Jails

Cloudsync

Control and monitor status and attributes for each TrueNAS cloudsync task. Jail control is available through services.

Cloudsync

Replication Tasks

Monitor status and attributes for each TrueNAS replication task.

Replication Tasks

Snapshot Tasks

Monitor status and attributes for each TrueNAS snapshot task.

Snapshot Tasks

Dataset Snapshot

Create a Dataset Snapshot using Homeassistant service. Snapshot name will be automatically generated using datetime iso format with microseconds and "custom" prefix.

Snapshot UI Snapshot YAML

Services

Control and monitor status and attributes for each TrueNAS service. Service control is available through services.

Services

Reboot and Shutdown

Reboot or Shutdown a TrueNAS system. Service control is available through services. Target system uptime sensor.

Install integration

This integration is distributed using HACS.

You can find it under "Integrations", named "TrueNAS"

Minimum requirements:

  • TrueNAS Core 12.0 or TrueNAS Scale (Any version)
  • Home Assistant 2022.2.0

Using TrueNAS development branch

If you are using development branch for TrueNAS, some features may stop working.

Setup integration

  1. Create an API key for Home Assistant on your TrueNAS system.

Setup step 1 Setup step 2 Setup step 3

  1. Setup this integration for your TrueNAS device in Home Assistant via Configuration -> Integrations -> Add -> TrueNAS. You can add this integration several times for different devices.

NOTES:

  • If you dont see "TrueNAS" integration, clear your browser cache.

Add Integration

  • "Name of the integration" - Friendly name for this router
  • "Host" - Use hostname or IP
  • "API key" - TrueNAS API key for Home Assistant

Development

Translation

To help out with the translation you need an account on Lokalise, the easiest way to get one is to click here then select "Log in with GitHub". After you have created your account click here to join TrueNAS Instegrations project on Lokalise.

If you want to add translations for a language that is not listed please open a Feature request.

Enabling debug

To enable debug for TrueNAS integration, add following to your configuration.yaml:

logger:
  default: info
  logs:
    custom_components.truenas: debug

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.