7.9 KiB
Home Assistant Community Add-on: Apache2
Apache2 Webserver for Homeassistant OS
About
The Apache HTTP Server Project is an effort to develop and maintain an open-source HTTP server for modern operating systems including UNIX and Windows. The goal of this project is to provide a secure, efficient and extensible server that provides HTTP services in sync with the current HTTP standards.
The Apache HTTP Server ("httpd") was launched in 1995 and it has been the most popular web server on the Internet since April 1996. It has celebrated its 25th birthday as a project in February 2020.
The Apache HTTP Server is a project of The Apache Software Foundation.
Different Versions
Full Version
The full Apache2 Version with MariaDB and common used PHP modules.
This docker image comes with: apache2 php7-apache2 libxml2-dev apache2-utils apache2-mod-wsgi apache2-ssl mariadb-client
The following php7 extensions will be installed: php7 php7-dev php7-fpm php7-mysqli php7-opcache php7-gd php7-zlib php7-curl php7-phar php7-json php7-mbstring php7-mcrypt php7-zip php7-pdo php7-pdo_mysql php7-iconv php7-dom php7-session php7-intl php7-soap php7-fileinfo php7-xml
And it comes with php7 locales and Mosquitto-PHP.
Minimal Version
The Minimal Version of the Apache2 Addon without MariaDB and with no PHP modules.
This docker image comes with: apache2 libxml2-dev apache2-utils apache2-mod-wsgi apache2-ssl
Minimal Version with MariaDB
The Minimal Version with MariaDB and some PHP modules of the Apache2 Addon.
This docker image comes with: apache2 php7-apache2 libxml2-dev apache2-utils apache2-mod-wsgi apache2-ssl mariadb-client
The following php7 extensions will be installed: php7 php7-mysqli php7-opcache php7-curl php7-json php7-mbstring php7-mcrypt php7-zip
Installation
The installation of this add-on is pretty straightforward and not different in comparison to installing any other custom Home Assistant add-on.
Just click the link above or add my repo to the hassio addons repositorys: https://github.com/FaserF/hassio-addons
Put your website files to /share/htdocs
Example File where your index.html should be: /share/htdocs/index.html
If you want to integrate your website with a mariadb database. Please ensure that the MariaDB Addon is installed!
Configuration
Note: Remember to restart the add-on when the configuration is changed.
Example add-on configuration:
document_root: /media/apache2
php_ini: /share/apache2/php.ini
default_conf: /share/apache2/000-default.conf
default_ssl_conf: get_file
website_name: itdoesntmatter_as_ssl_is_set_to_false
username: apache
password: mySecretPassword
ssl: false
certfile: itdoesntmatter_as_ssl_is_set_to_false
keyfile: itdoesntmatter_as_ssl_is_set_to_false
Recommended Example add-on configuration:
document_root: /share/htdocs
php_ini: default
default_conf: default
default_ssl_conf: default
website_name: mywebsite.ddns.net
ssl: true
certfile: fullchain.pem
keyfile: privkey.pem
Note: This is just an example, don't copy and paste it! Create your own!
Option: document_root
This option is needed. Change it depending where your root webfolder is on your homeassistant installation.
Note: it has to be somewhere in the /share or /media folder! Other folders are not visible to this addon.
Option: php_ini
You can choose between the following options:
default -> the default php7 php.ini file will be used
get_file -> copies the default php7 php.ini file from the addon to /share/apache2addon_php.ini
path/to/your/new/php.ini -> Please change the location depending where your custom php.ini file is, f.e.: /share/apache2/php.ini
Option: default_conf & default_ssl_conf
You can choose between the following options:
default -> the default apache2 addon file will be used
get_config -> Get a copy of the default apache2 addon config file to your /share folder.
path/to/your/new/apache2.conf -> Please change the location depending where your custom 000-default.conf / 000-default-le-ssl.conf file is, f.e.: /share/apache2/000-default.conf
More Information: https://cwiki.apache.org/confluence/display/HTTPD/ExampleVhosts
Please note, that I wont give any support if you are using custom apache2 config files and are recieving any apache2 errors!
Option: website_name
This option is needed, if you enable ssl to true. If you are not using SSL put anything in here, as it doesnt matter.
Option: username
This option is optional. Set a username to access the webfiles.
Option: password
This option is optional. Set a password to access the webfiles.
Option: ssl
Enables/Disables SSL (HTTPS) on the web interface. Set it true to enable it, false otherwise.
If you need a self-signed certificate, have a look at my openssl addon: https://github.com/FaserF/hassio-addons/tree/master/openssl
Note: The files MUST be stored in /ssl/, which is the default
Ingress
This addon supports Homeassistant Ingress. Until now it seems only to work if you enable SSL! And also I am sorry, but I cant support all your websites. Basic HTML Websites will work great with ingress, the more advanced the page is, the harder it is to support ingress.
Support
Got questions or problems?
You can open an issue here GitHub. Please keep in mind, that this software is only tested on armv7 running on a Raspberry Pi 4.
Authors & contributors
The original program is from the Apache Project. For more informatios please visit this page: https://httpd.apache.org/ The hassio addon is brought to you by FaserF.
License
MIT License
Copyright (c) 2019-2021 FaserF & The Apache Project
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.