snapcraft.yaml 8.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241
  1. name: home-assistant-snap
  2. title: Home assistant
  3. version: '2021.10.0'
  4. icon: snap/gui/home-assistant-snap.svg
  5. summary: Open source home automation that puts local control and privacy first
  6. description: |
  7. Home Assistant is a free and open-source software for home automation that is designed to be the central control system for smart home devices with focus on local control and privacy.
  8. It can be accessed via a web-based user interface, via companion apps for Android and iOS, or using voice commands via a supported virtual assistant like Google Assistant or Amazon Alexa.
  9. Home Assistant integrates with over a thousand different devices and services.
  10. Read more about Home Assistant at
  11. - https://en.wikipedia.org/wiki/Home_Assistant
  12. - https://www.home-assistant.io/
  13. **NOTE!** This is Home Assistant Core (not supervised).
  14. Your new installation will be available through your browser at http://localhost:8123/ (or change localhost to any other IP address where the snap packages is installed). You will get a launcher available in your application menu on desktops.
  15. **Important information about updates**
  16. Since each major versions of Home Assistant might bring breaking changes, you will **only** auto-update for minor releases. Each major release must be upgraded manually, by switching channel.
  17. See available channels in the software center or with
  18. `snap info home-assistant-snap`
  19. Please use the stable versions, e.g `2021.8/stable`.
  20. You can switch channel with:
  21. `
  22. $ snap switch home-assistant-snap --channel=<channel>
  23. `
  24. where `<channel>` could be `2021.8/stable`.
  25. There is a binary sensor `binary_sensor.updater` that will flip to `true` from `false` whenever there are updates available in a newer channel. Use this to show a notification whenever a new major release is available.
  26. **Need help?**
  27. Please use https://www.home-assistant.io/docs/ for documentation and https://community.home-assistant.io for help from the community.
  28. **Necessary plugs**
  29. Can't connect to your USB (e.g Zigbee, Z-wave, removable drive)?
  30. See `snap connections home-assistant-snap` for necessary plugs (such as access to USB, removable media etc) and connect them with
  31. `$ snap connect home-assistant-snap:<plug>`
  32. where `<plug>` can be in example `raw-usb`.
  33. **Required plugs**
  34. - *network:* allows Home Assistant access to the network.
  35. - *network-bind:* allows operating as a network service, to run the Home Assistant server.
  36. - *network-control:* enables the configuration of networking and network namespaces via `ip netns`, providing a wide, privileged access to networking. This is required for the DHCP discovery integration to work which will watch the network for DHCP requests for supported devices and services. To disable this feature you will have to disable the `default_config` from you `configuration.yaml` and disconnect the `network-control` plug with `snap disconnect home-assistant-snap:network-control`.
  37. **NOTE!** Removing the `default_config` will require you to build up a whole new configuration for Home Assistant. More on what is enabled by default at this link: https://www.home-assistant.io/integrations/default_config/
  38. **Optional plugs**
  39. - *raw-usb:* allows access to all connected USB devices via a raw interface.
  40. - *removable-media*: allows read/write access to mounted removable storage in /media, /run/media and /mnt.
  41. - *serial-port*: enables access to a specific serial port. This interface is restricted because it provides privileged access to configure serial port hardware. Might require hot-plug support `snap set system experimental.hotplug=true` followed by `systemctl restart snapd`.
  42. **Available slots**
  43. - *components:* Load custom components to Home Assistant. You will find the Home Assistant Community Store package here: https://snapcraft.io/home-assistant-hacs - Installations on own risk and note that provided integrations are not tested or guaranteed to work.
  44. - *bin:* Missing binaries might be in the Home Assistant Toolbox, such as cURL etc. See https://snapcraft.io/home-assistant-toolbox
  45. - *configurations:* Edit your configuration files with `code-server` (VS Code) or HASS configurator:
  46. - https://snapcraft.io/code-server
  47. - https://snapcraft.io/home-assistant-configurator.
  48. # source-code: "https://github.com/home-assistant-snap/home-assistant-snap"
  49. # website: "https://github.com/home-assistant-snap/home-assistant-snap"
  50. # issues: "https://github.com/home-assistant-snap/home-assistant-snap/issues"
  51. # donation: "https://www.paypal.com/donate/?hosted_button_id=69NA8SXXFBDBN"
  52. license: Apache-2.0
  53. base: core20
  54. grade: stable
  55. confinement: strict
  56. architectures:
  57. - build-on: amd64
  58. - build-on: arm64
  59. - build-on: armhf
  60. #- build-on: ppc64el
  61. layout:
  62. /usr/local/lib:
  63. bind: $SNAP/usr/lib/${SNAPCRAFT_ARCH_TRIPLET}
  64. /etc/pip.conf:
  65. bind-file: $SNAP_COMMON/pip.conf
  66. /etc/openzwave:
  67. bind: $SNAP/openzwave
  68. /etc/ethertypes:
  69. bind-file: $SNAP/etc/ethertypes
  70. /etc/protocols:
  71. bind-file: $SNAP/etc/protocols
  72. /etc/services:
  73. bind-file: $SNAP/etc/services
  74. plugs:
  75. bin:
  76. interface: content
  77. content: executables
  78. target: $SNAP/shared-bin
  79. slots:
  80. components:
  81. interface: content
  82. content: components
  83. write:
  84. - $SNAP_DATA/custom_components
  85. configurations:
  86. interface: content
  87. write:
  88. - $SNAP_DATA
  89. vscs-content:
  90. interface: content
  91. write:
  92. - $SNAP_DATA
  93. apps:
  94. home-assistant-snap:
  95. command: bin/hass --config $SNAP_DATA
  96. command-chain:
  97. - bin/plug-bin
  98. daemon: simple
  99. environment:
  100. PIP_USER: 1
  101. restart-condition: always
  102. plugs:
  103. - bluez
  104. - network
  105. - network-bind
  106. - network-control
  107. - raw-usb
  108. - serial-port
  109. - physical-memory-control
  110. - removable-media
  111. slots:
  112. - components
  113. open-localhost:
  114. command: bin/open-localhost
  115. plugs:
  116. - desktop
  117. check-config:
  118. plugs:
  119. - network
  120. environment:
  121. PIP_USER: 1
  122. command: bin/hass --script check_config --config $SNAP_DATA -i
  123. parts:
  124. homeassistant:
  125. plugin: python #-wot-plugin
  126. source: https://github.com/home-assistant/core.git
  127. source-tag: ${SNAPCRAFT_PROJECT_VERSION}
  128. python-packages:
  129. - setuptools<58
  130. - wheel
  131. - Cython
  132. build-packages:
  133. - python3
  134. - python3-dev
  135. - pkg-config
  136. - autoconf
  137. - build-essential
  138. - cmake
  139. - cython3
  140. - ffmpeg
  141. - libavcodec-dev
  142. - libavdevice-dev
  143. - libavfilter-dev
  144. - libavformat-dev
  145. - libavresample-dev
  146. - libavutil-dev
  147. - libffi-dev
  148. - libglib2.0-dev
  149. - libglu1-mesa-dev
  150. - libgpiod-dev
  151. - libjpeg-dev
  152. - libopenzwave1.5-dev
  153. - libpcap0.8-dev
  154. - libswresample-dev
  155. - libssl-dev
  156. - libswscale-dev
  157. - libudev-dev
  158. - libxml2-dev
  159. - libxslt1-dev
  160. - zlib1g-dev
  161. stage-packages:
  162. - freeglut3
  163. - ffmpeg
  164. - libglu1-mesa
  165. - libpcap0.8
  166. - libpcap0.8-dev
  167. - libpulse0
  168. - libturbojpeg
  169. - netbase
  170. - tcpdump
  171. - zlib1g
  172. stage:
  173. - -lib/python3.8/site-packages/homeassistant/components/updater
  174. - -lib/python3.8/site-packages/aiogithubapi*
  175. requirements:
  176. - requirements_all.txt
  177. constraints:
  178. - homeassistant/package_constraints.txt
  179. override-build: |
  180. snapcraftctl build
  181. sed -i 's/include-system-site-packages = false/include-system-site-packages = true/g' $SNAPCRAFT_PART_INSTALL/pyvenv.cfg
  182. updater:
  183. after: [homeassistant]
  184. plugin: dump
  185. source: ./src/components
  186. source-type: local
  187. organize:
  188. '*': lib/python3.8/site-packages/homeassistant/components/
  189. bins:
  190. plugin: dump
  191. source: ./src/bin
  192. source-type: local
  193. organize:
  194. open-localhost: bin/open-localhost
  195. hooks:
  196. plugin: dump
  197. source: ./src/hooks
  198. source-type: local
  199. stage-packages:
  200. - uuid
  201. organize:
  202. install: snap/hooks/install
  203. configure: snap/hooks/configure
  204. post-refresh: snap/hooks/post-refresh
  205. connect-plug-bin: snap/hooks/connect-plug-bin
  206. config:
  207. plugin: dump
  208. source: ./src/config
  209. source-type: local
  210. organize:
  211. plug-bin: bin/plug-bin