snapcraft.yaml 9.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308
  1. name: home-assistant-snap
  2. title: Home assistant
  3. version: '2021.12.3'
  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. #PYTHONPATH: "$PYTHONPATH:$SNAP/lib/python3.9/site-packages"
  102. restart-condition: always
  103. plugs:
  104. - bluez
  105. - network
  106. - network-bind
  107. - network-control
  108. - hardware-observe
  109. - raw-usb
  110. - serial-port
  111. - physical-memory-control
  112. - removable-media
  113. slots:
  114. - components
  115. open-localhost:
  116. command: bin/open-localhost
  117. plugs:
  118. - desktop
  119. check-config:
  120. plugs:
  121. - network
  122. environment:
  123. PIP_USER: 1
  124. command: bin/hass --script check_config --config $SNAP_DATA -i
  125. # package-repositories:
  126. # - type: apt
  127. # ppa: deadsnakes/ppa
  128. parts:
  129. python:
  130. plugin: autotools
  131. source: https://www.python.org/ftp/python/3.9.8/Python-3.9.8.tgz
  132. autotools-configure-parameters:
  133. - --enable-optimizations
  134. build-packages:
  135. - build-essential
  136. - gdb
  137. - lcov
  138. - pkg-config
  139. - libbz2-dev
  140. - libffi-dev
  141. - libgdbm-dev
  142. - libgdbm-compat-dev
  143. - liblzma-dev
  144. - libncurses5-dev
  145. - libreadline6-dev
  146. - libsqlite3-dev
  147. - libssl-dev
  148. - lzma
  149. - lzma-dev
  150. - tk-dev
  151. - uuid-dev
  152. - zlib1g-dev
  153. override-stage: |
  154. snapcraftctl stage
  155. [ ! -d "${SNAPCRAFT_STAGE}/bin" ] && mkdir ${SNAPCRAFT_STAGE}/bin
  156. ln -s ../usr/local/bin/python3.9 "${SNAPCRAFT_STAGE}/bin/python3.9"
  157. ln -s ../usr/local/bin/python3.9 "${SNAPCRAFT_STAGE}/usr/bin/python3"
  158. stage-packages:
  159. - libfontconfig1
  160. - libfreetype6
  161. - libgdbm-compat4
  162. - libgdbm6
  163. - libpng16-16
  164. - libtcl8.6
  165. - libtk8.6
  166. - libx11-6
  167. - libxau6
  168. - libxcb1
  169. - libxdmcp6
  170. - libxext6
  171. - libxft2
  172. - libxrender1
  173. - libxss1
  174. homeassistant:
  175. after: [python]
  176. plugin: python #-wot-plugin
  177. source: https://github.com/home-assistant/core.git
  178. source-tag: ${SNAPCRAFT_PROJECT_VERSION}
  179. build-environment:
  180. - SNAPCRAFT_PYTHON_INTERPRETER: python3.9
  181. python-packages:
  182. - setuptools<58
  183. - wheel
  184. - Cython
  185. - pip
  186. build-packages:
  187. - autoconf
  188. - build-essential
  189. - cmake
  190. - cython3
  191. - ffmpeg
  192. - libavcodec-dev
  193. - libavdevice-dev
  194. - libavfilter-dev
  195. - libavformat-dev
  196. - libavresample-dev
  197. - libavutil-dev
  198. - libcrypt-dev
  199. - libffi-dev
  200. - libglib2.0-dev
  201. - libglu1-mesa-dev
  202. - libgpiod-dev
  203. - libjpeg-dev
  204. - libopenzwave1.5-dev
  205. - libpcap0.8-dev
  206. - libswresample-dev
  207. - libssl-dev
  208. - libswscale-dev
  209. - libudev-dev
  210. - libxml2-dev
  211. - libxslt1-dev
  212. - pkg-config
  213. - python3-pip
  214. - python3.9-dev
  215. - zlib1g-dev
  216. - on armhf:
  217. - cargo
  218. # - dpkg-dev
  219. # - gcc
  220. # - libfreetype-dev
  221. # - make
  222. - rustc
  223. - on ppc64el:
  224. - cargo
  225. - rustc
  226. stage-packages:
  227. - freeglut3
  228. - ffmpeg
  229. - libglu1-mesa
  230. - libpcap0.8
  231. - libpcap0.8-dev
  232. - libpulse0
  233. - libturbojpeg
  234. - netbase
  235. - tcpdump
  236. - zlib1g
  237. stage:
  238. - -lib/python3.9/site-packages/homeassistant/components/updater
  239. - -lib/python3.9/site-packages/aiogithubapi*
  240. requirements:
  241. - requirements_all.txt
  242. constraints:
  243. - homeassistant/package_constraints.txt
  244. override-stage: |
  245. snapcraftctl stage
  246. sed -i 's/include-system-site-packages = false/include-system-site-packages = true/g' $SNAPCRAFT_STAGE/pyvenv.cfg
  247. updater:
  248. after: [homeassistant]
  249. plugin: dump
  250. source: ./src/components
  251. source-type: local
  252. organize:
  253. '*': lib/python3.9/site-packages/homeassistant/components/
  254. bins:
  255. plugin: dump
  256. source: ./src/bin
  257. source-type: local
  258. organize:
  259. open-localhost: bin/open-localhost
  260. hooks:
  261. plugin: dump
  262. source: ./src/hooks
  263. source-type: local
  264. stage-packages:
  265. - uuid
  266. organize:
  267. install: snap/hooks/install
  268. configure: snap/hooks/configure
  269. post-refresh: snap/hooks/post-refresh
  270. connect-plug-bin: snap/hooks/connect-plug-bin
  271. config:
  272. plugin: dump
  273. source: ./src/config
  274. source-type: local
  275. organize:
  276. plug-bin: bin/plug-bin