https://github.com/enricodeleo/hassio-addon-nextcloud
Nextcloud add-on for all the Home Assistant lovers out there.
https://github.com/enricodeleo/hassio-addon-nextcloud
Last synced: 3 months ago
JSON representation
Nextcloud add-on for all the Home Assistant lovers out there.
- Host: GitHub
- URL: https://github.com/enricodeleo/hassio-addon-nextcloud
- Owner: enricodeleo
- License: mit
- Created: 2021-06-29T17:54:05.000Z (almost 4 years ago)
- Default Branch: master
- Last Pushed: 2021-10-26T23:07:47.000Z (over 3 years ago)
- Last Synced: 2025-01-19T23:49:17.264Z (5 months ago)
- Language: Dockerfile
- Size: 165 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
README
# 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://home-assistant.io/hassio/installing_third_party_addons/):
```txt
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:
```yaml
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 :
```yaml
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](https://github.com/hassio-addons/addon-nginx-proxy-manager) 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](https://github.com/mtthp/hassio-addons/blob/master/nextcloud/TROUBLESHOOT.md) guide before opening an issue.
## Acknowledgement
All credits to [original project](https://github.com/mtthp/hassio-addons) from where this repository has been originally cloned. The purpose of this repo is having a dedicated repository for Nextcloud.
- [Matthieu Petit](https://github.com/mtthp) for the [oroginal project](https://github.com/mtthp/hassio-addons)
- [Patrick Streule](https://github.com/pstreule) for the [README](https://github.com/pstreule/hassio-addons/blob/master/README.md)
- [home-assistant](https://github.com/home-assistant) for the [build workflow](https://github.com/home-assistant/addons-development/blob/master/.github/workflows/builder.yml)