provide mechanism for custom .well-known handlers and static files (e.g. for letsencypt ownership verification). Document that if you create a .well-known directory to validate a letsencrypt cert you need to remove it before installing hubzilla. We probably need a check for this in the install checklist.

install/INSTALL.txt

@@ -62,6 +62,14 @@ When communicating with new sites, Hubzilla always attempts connection on the
 SSL port first, before falling back to a less secure connection.  If you do not
 use SSL, your webserver MUST NOT listen on port 443 at all.
 
+If you use LetsEncrypt to provide certificates and create a file under 
+.well-known/acme-challenge so that LetsEncrypt can verify your domain ownership, 
+please remove or rename the .well-known directory as soon as the certificate is 
+generated. Hubzilla will provide its own handler for ".well-known" services when
+it is installed, and an existing directory in this location may prevent some of 
+these services from working correctly. 
+
+
 1. Requirements
     - Apache with mod-rewrite enabled and "AllowOverride All" so you can use a 
     local .htaccess file. Some folks have successfully used nginx and lighttpd.

mod/_well_known.php

@@ -33,6 +33,19 @@ function _well_known_init(&$a){
 				break;
 
 			default:
+				// look in $WEBROOT/well_known for the requested file in case it is 
+				// something a site requires and for which we do not have a module
+
+				// @fixme - we may need to determine the content-type and stick it in the header
+				// for now this can be done with a php script masquerading as the requested file
+
+				$wk_file = str_replace('.well-known','well_known',$a->cmd);
+				if(file_exists($wk_file)) {
+					echo file_get_contents($wk_file); 
+					killme();
+				}
+				elseif(file_exists($wk_file . '.php'))
+					require_once($wk_file . '.php');
 				break;
 
 		}

mod/hostxrd.php

@@ -12,6 +12,7 @@ function hostxrd_init(&$a) {
 	));
 	$arr = array('xrd' => $x);
 	call_hooks('hostxrd',$arr);
+
 	echo $arr['xrd'];
 	killme();
 }

version.inc

@@ -1 +1 @@
-2016-01-21.1285H
+2016-01-22.1286H