|
|
@@ -1,19 +1,19 @@
|
|
|
# Home Assistant (snap)
|
|
|
|
|
|
-Snap (Snapcraft.yaml) recipe for the Open source home automation software, [Home Assistant](https://www.home-assistant.io/) that puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts. Perfect to run on a Raspberry Pi or a local server.
|
|
|
+Snap (Snapcraft.yaml) recipe for the Open source home automation software [Home Assistant](https://www.home-assistant.io/), which puts local control and privacy first. Powered by a worldwide community of tinkerers and DIY enthusiasts. Perfect for running on a Raspberry Pi or a local server.
|
|
|
|
|
|
This page will only include specific information about the snap-version of Home Assistant. For general Home Assistant questions, see their official [Help page](https://www.home-assistant.io/help/) and [Community Forum](https://community.home-assistant.io/).
|
|
|
|
|
|
-Our tagging is reflecting the Home Assistant version numbers, but we might not release a tag for each version of Home Assistant.
|
|
|
+Our tagging reflects the Home Assistant version numbers, but we might not release a tag for each version of Home Assistant.
|
|
|
|
|
|
[](https://snapcraft.io/home-assistant-snap)
|
|
|
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=69NA8SXXFBDBN&source=https://git.giaever.org/joachimmg/home-assistant-snap)
|
|
|
|
|
|
## About this project
|
|
|
|
|
|
-This snap-version of Home Assistant was made with the intention of running a home automation system on multiple remote location. Snap was choosen as it is an transactional, self updating package manager, which will let us not have to travel to the location(s) to do updates on each system.
|
|
|
+This snap-version of Home Assistant was made with the intention of running a home automation system on multiple remote locations. Snap was chosen as it is a transactional, self updating package manager, which enables systems (in remote locations) to perform updates without needing physical supervision.
|
|
|
|
|
|
-Based on this intention we have choosen a strict confinement, which should work out of the box on the [Ubuntu Core](https://ubuntu.com/core) operating system and similar. As changes to the snap on these systems are limited we have also built several other snaps that will integrate with this version or help manage devices remotely.
|
|
|
+Based on this intention we have chosen a strict confinement, which should work out of the box on the [Ubuntu Core](https://ubuntu.com/core) operating system and similar. As changes to the snap on these systems are limited we have also built several other snaps that will integrate with this version or help manage devices remotely.
|
|
|
|
|
|
* [Home Assistant Community Store](https://git.giaever.org/joachimmg/home-assistant-hacs)-integration gives you a powerful UI to handle downloads of all your custom needs.
|
|
|
* [HASS Configurator](https://git.giaever.org/joachimmg/home-assistant-configurator)-integration to allow easy configuration of Home Assistant.
|
|
|
@@ -26,9 +26,9 @@ Please file all issues using the main git-repository found at [git.giaever.org](
|
|
|
|
|
|
## Frequently asked questions
|
|
|
|
|
|
-* **How do I configure Home Assistant from this snap**
|
|
|
- * If your using Home Assistant on a desktop or server edition you will be able to use your favourite text editor. The configurations files is store in `/var/snap/home-assistant-snap/current`. You will need to have root access.
|
|
|
- * If you can't locate the configuration files (it may differ on some distributions), log into the daemon' shell with `sudo snap run --shell home-assistant-snap` and execute `echo $SNAP_DATA`. This should return a path similar that is mentioned above, but containing a digit (the revision number of the current running version). When you have figured out the path, it's wise to exchange the `revision number` with `current`, as this number will change frequently and `current` will always be linked to the currently used revision.
|
|
|
+* **How do I configure Home Assistant from this snap?**
|
|
|
+ * If you're using Home Assistant on a desktop or server edition you will be able to use your favourite text editor. The configurations files are stored in `/var/snap/home-assistant-snap/current`. You will need to have root access.
|
|
|
+ * If you can't locate the configuration files (it may differ on some distributions), log into the daemon's shell with `sudo snap run --shell home-assistant-snap` and execute `echo $SNAP_DATA`. This should return a path similar to what is mentioned above, but containing a digit (the revision number of the current running version). When you have figured out the path, it's wise to exchange the `revision number` with `current`, as this number will change frequently and `current` will always be linked to the currently used revision.
|
|
|
* If you don't have root access or want to be able to update the configurations through a web solution, have a look at the [home-assistant-configurator](https://git.giaever.org/joachimmg/home-assistant-configurator).
|
|
|
* **How can I secure my Home Assistant with SSL (HTTPS)?**
|
|
|
* Install [acme-sh](https://git.giaever.org/joachimmg/acme-sh) and connect `acme-sh`'s and home-assistant-snap's slot/plug with `snap connect acme-sh:certs home-assistant-snap:certs`.
|
|
|
@@ -48,7 +48,7 @@ $ snap install home-assistant-snap
|
|
|
|
|
|
### Build this snap from source
|
|
|
|
|
|
-We recommend that your download a pre-built version of this snap from [The Snap Store](https://snapcraft.io/home-assistant-snap), or at least make sure that you checkout the latest tag, as the master tag might contain faulty code during development.
|
|
|
+We recommend that you download a pre-built version of this snap from [The Snap Store](https://snapcraft.io/home-assistant-snap), or at least make sure that you checkout the latest tag, as the master tag might contain faulty code during development.
|
|
|
|
|
|
1. **Clone this repo and checkout the latest tag**
|
|
|
|
|
|
@@ -87,7 +87,7 @@ $ snapcraft
|
|
|
|
|
|
Multipass will be installed and a virtual machine will boot up and build your snap. The final snap will be located in the same directory.
|
|
|
|
|
|
-2.3 **With LXD** (*required* for Raspberry Pie)
|
|
|
+2.3 **With LXD** (*required* for Raspberry Pi)
|
|
|
|
|
|
Snapcraft will try to install multiplass and build the snap for you, but on *Raspberry Pi* it will fail. You will have to use an LXD container.
|
|
|
|
