Nextcloud add-on for Home Assistant

About

Nextcloud is a suite of client-server software for creating and using file hosting services. Nextcloud application functionally is similar to Dropbox. Unlike Dropbox, Nextcloud does not offer off-premises file storage hosting.

A safe home for all your data. Access & share your files, calendars, contacts, mail & more from any device, on your terms.

Requirements

• Home Assistant
• MYSQL Server with a database and user

Install

These add-ons can be installed in Home Assistant by configuring the following URL in the Hass.io panel:

https://github.com/enricodeleo/hassio-addon-nextcloud

Config

• Add a user/database for Nextcloud to your MYSQL. If you use the MariaDB-Addon you can create a new user in the Addon-Config.

Example Config:

databases:
  - homeassistant
  - nextcloud
logins:
  - username: homeassistant
    password: YOURPASSWORD
  - username: nextcloud
    password: YOURPASSWORD
rights:
  - username: homeassistant
    database: homeassistant
  - username: nextcloud
    database: nextcloud

• Configure Nextcloud addon accordingly :

MYSQL_DATABASE: nextcloud                         # The Database you created in step above.
MYSQL_USER: nextcloud                             # The User you created in step above.
MYSQL_PASSWORD: aRandomPassword                   # The Password you created in step above.
MYSQL_HOST: addon_core_mariadb                    # The Host of your SQL-Server. The default port is 3306.
NEXTCLOUD_ADMIN_USER: someUsername                # The User for your Nextcloud-instance.
NEXTCLOUD_ADMIN_PASSWORD: somePassword            # The Password for your Nextcloud-instance.
NEXTCLOUD_TRUSTED_DOMAINS: cloud.yourdomain.com   # The Domain for your Nextcloud-instance. Can also be a local IP for local access i.e: 192.168.178.5
TRUSTED_PROXIES: 127.0.0.1 172.30.33.0/24 192.168.1.1   # Allowed origin ip of proxies

This list is not exhaustive. The documentation for env variables can be found at https://github.com/docker-library/docs/blob/master/nextcloud/README.md#auto-configuration-via-environment-variables. Do not forget to map a port to your host.

Start

• Start the addon. Wait a while and check the log for any errors.
• Open yourdomain.com:8888 (where ":8888" is the port configured in the Nextcloud addon).

SSL

• Add SSL with something like Nginx Proxy Manager addon for example with the Port from step above.
• Enjoy Nextcloud with SSL and without adding ":8888" to your Domain.

Troubleshooting

If you have in issue with your installation, please be sure to checkout the TROUBLESHOOT guide before opening an issue.

Acknowledgement

All credits to original project from where this repository has been originally cloned. The purpose of this repo is having a dedicated repository for Nextcloud.

• Matthieu Petit for the oroginal project
• Patrick Streule for the README
• home-assistant for the build workflow