summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFrederic Guillot <fred@kanboard.net>2015-09-29 22:21:48 -0400
committerFrederic Guillot <fred@kanboard.net>2015-09-29 22:21:48 -0400
commit421e8751ebca5b566ecbd8d08e9d56b93ce81ffa (patch)
treef719c8442b0868148356b0c8d8b52e0ac6b85519
parentf0a09a075bef59c735b850bc73a4b8400adb31b4 (diff)
Update url rewrite doc for nginx
-rw-r--r--doc/nice-urls.markdown46
1 files changed, 45 insertions, 1 deletions
diff --git a/doc/nice-urls.markdown b/doc/nice-urls.markdown
index 38f7c41d..fc0a3bf3 100644
--- a/doc/nice-urls.markdown
+++ b/doc/nice-urls.markdown
@@ -24,7 +24,7 @@ By default, Kanboard will check if the Apache mode rewrite is enabled.
To avoid the automatic detection of url rewriting from the web server, you can enable this feature in your config file:
-```
+```php
define('ENABLE_URL_REWRITE', true);
```
@@ -34,3 +34,47 @@ When this constant is at `true`:
- If you use another web server than Apache, by example Nginx or Microsoft IIS, you have to configure yourself the url rewriting
Note: Kanboard always fallback to old school urls when it's not configured, this configuration is optional.
+
+Nginx configuration example
+---------------------------
+
+In the section `server` of your Nginx config file you can use this example:
+
+```bash
+index index.php;
+
+location / {
+ try_files $uri $uri/ /index.php;
+
+ # If Kanboard is under a subfolder
+ # try_files $uri $uri/ /kanboard/index.php;
+}
+
+location ~ \.php$ {
+ try_files $uri =404;
+ fastcgi_split_path_info ^(.+\.php)(/.+)$;
+ fastcgi_pass unix:/var/run/php5-fpm.sock;
+ fastcgi_index index.php;
+ include fastcgi_params;
+}
+
+# Deny access to the directory data
+location ~* /data {
+ deny all;
+ return 404;
+}
+
+# Deny access to .htaccess
+location ~ /\.ht {
+ deny all;
+ return 404;
+}
+```
+
+In your Kanboard `config.php`:
+
+```php
+define('ENABLE_URL_REWRITE', true);
+```
+
+Adapt the example above according to your own configuration.