Home Assistant: Difference between revisions

Line 4:

Upstream has defined several installation methods which they are willing to support. NixOS is obviously not one of them. If you find a problem you can still report it upstream if you are certain that the issue is relevant to upstreams supported installation methods as well. If not, or if in doubt, please open an isssue on the nixpkgs issue tracker or visit us via matrix in [https://matrix.to/#/#nixos-homeautomation:lossy.network?via=lossy.network&via=matrix.org&via=kack.it #nixos-homeautomation:lossy.network].

= Running a recent version using an overlay =

Home Assistant is a fast-paced open source project, that currently features one major release every month, and a handful of minor ones in between. Firmwares and API endpoints tend to change from time to time, so Home Assistant and its bindings need to keep up to keep things work. The version we provide at the branch off is just a snapshot in time, and does not receive any updates, because there would just be too many dependencies to backport. But with NixOS it is still possible to use the version in nixpkgs/unstable by creating an overlay.

let

# Track NixOS unstable via nix-channel, or replace it with something like niv at your own discretion

# nix-channel --add http://nixos.org/channels/nixos-unstable nixos-unstable

unstable = import <nixos-unstable> {};

{

nixpkgs.overlays = [

(self: super: {

inherit (unstable) home-assistant;

}

];

disabledModules = [

"services/misc/home-assistant.nix"

];

imports = [

"${unstable}/nixos/modules/services/misc/home-assistant.nix"

];

}

</syntaxHighlight>

= Home Assistant with nginx as a reverse proxy =

@@ Line 4: / Line 4: @@
 Upstream has defined several installation methods which they are willing to support.  NixOS is obviously not one of them. If you find a problem you can still report it upstream if you are certain that the issue is relevant to upstreams supported installation methods as well. If not, or if in doubt, please open an isssue on the nixpkgs issue tracker or visit us via matrix in [https://matrix.to/#/#nixos-homeautomation:lossy.network?via=lossy.network&via=matrix.org&via=kack.it #nixos-homeautomation:lossy.network].
+= Running a recent version using an overlay =
+Home Assistant is a fast-paced open source project, that currently features one major release every month, and a handful of minor ones in between. Firmwares and API endpoints tend to change from time to  time, so Home Assistant and its bindings need to keep up to keep things work. The version we provide at the branch off is just a snapshot in time, and does not receive any updates, because there would just be too many dependencies to backport. But with NixOS it is still possible to use the version in nixpkgs/unstable by creating an overlay.
+<syntaxHighlight lang=nix>
+let
+  # Track NixOS unstable via nix-channel, or replace it with something like niv at your own discretion
+  # nix-channel --add http://nixos.org/channels/nixos-unstable nixos-unstable
+  unstable = import <nixos-unstable> {};
+{
+  nixpkgs.overlays = [
+    (self: super: {
+      inherit (unstable) home-assistant;
+    }
+  ];
+  disabledModules = [
+    "services/misc/home-assistant.nix"
+  ];
+  imports = [
+    "${unstable}/nixos/modules/services/misc/home-assistant.nix"
+  ];
+}
+</syntaxHighlight>
 = Home Assistant with nginx as a reverse proxy =