X-Git-Url: https://git.immae.eu/?a=blobdiff_plain;f=doc%2Fmd%2FServer-configuration.md;h=66db8c570c37ee81b790dda9cd94550b869d2451;hb=8a9796014ce6c842095a9d031c8cbf40da761e0f;hp=14070c8abc7dfc443c630718f0fb024a734b6a13;hpb=ec457491879893c8cfcc9dd6542d1593aa5c91f5;p=github%2Fshaarli%2FShaarli.git
diff --git a/doc/md/Server-configuration.md b/doc/md/Server-configuration.md
index 14070c8a..66db8c57 100644
--- a/doc/md/Server-configuration.md
+++ b/doc/md/Server-configuration.md
@@ -193,19 +193,24 @@ sudo nano /etc/apache2/sites-available/shaarli.mydomain.org.conf
Require all granted
-
- # Prevent accessing dotfiles
- RedirectMatch 404 ".*"
-
+ # BE CAREFUL: directives order matter!
-
+
+ Require all denied
+
+
+
+ Require all granted
+
+
+
# allow client-side caching of static files
Header set Cache-Control "max-age=2628000, public, must-revalidate, proxy-revalidate"
-
+
+
# serve the Shaarli favicon from its custom location
Alias favicon.ico /var/www/shaarli.mydomain.org/images/favicon.ico
-
```
@@ -325,6 +330,11 @@ server {
deny all;
}
+ location ~ /doc/ {
+ default_type "text/html";
+ try_files $uri $uri/ $uri.html =404;
+ }
+
location = /favicon.ico {
# serve the Shaarli favicon from its custom location
alias /var/www/shaarli/images/favicon.ico;
@@ -362,7 +372,23 @@ sudo systemctl reload nginx
If Shaarli is hosted on a server behind a [reverse proxy](https://en.wikipedia.org/wiki/Reverse_proxy) (i.e. there is a proxy server between clients and the web server hosting Shaarli), configure it accordingly. See [Reverse proxy](Reverse-proxy.md) configuration.
+## Using Shaarli without URL rewriting
+
+By default, Shaarli uses Slim framework's URL, which requires
+URL rewriting.
+
+If you can't use URL rewriting for any reason (not supported by
+your web server, shared hosting, etc.), you *can* use Shaarli
+without URL rewriting.
+
+You just need to prefix your URL by `/index.php/`.
+Example: instead of accessing `https://shaarli.mydomain.org/`,
+use `https://shaarli.mydomain.org/index.php/`.
+**Recommended:**
+ * after installation, in the configuration page, set your header link to `/index.php/`.
+ * in your configuration file `config.json.php` set `general.root_url` to
+ `https://shaarli.mydomain.org/index.php/`.
## Allow import of large browser bookmarks export