aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/Troubleshooting.md
diff options
context:
space:
mode:
authorVirtualTam <virtualtam@flibidi.net>2015-08-18 00:33:25 +0200
committerVirtualTam <virtualtam@flibidi.net>2015-08-18 00:33:25 +0200
commit6335a0fc0ce0c2f962333f0b4d6baac1671df901 (patch)
tree8cb128628e987cd622f581eea55febb2b8544530 /doc/Troubleshooting.md
parentf8bf8d8e595a9128ebdf00091a648d186ba9a628 (diff)
downloadShaarli-6335a0fc0ce0c2f962333f0b4d6baac1671df901.tar.gz
Shaarli-6335a0fc0ce0c2f962333f0b4d6baac1671df901.tar.zst
Shaarli-6335a0fc0ce0c2f962333f0b4d6baac1671df901.zip
Doc: sync from Wiki, generate HTML
Signed-off-by: VirtualTam <virtualtam@flibidi.net>
Diffstat (limited to 'doc/Troubleshooting.md')
-rw-r--r--doc/Troubleshooting.md51
1 files changed, 48 insertions, 3 deletions
diff --git a/doc/Troubleshooting.md b/doc/Troubleshooting.md
index 4adf7c92..4e6cdb06 100644
--- a/doc/Troubleshooting.md
+++ b/doc/Troubleshooting.md
@@ -1,7 +1,53 @@
1#Troubleshooting 1#Troubleshooting
2## Browser
3### Redirection issues (HTTP Referer)
4Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.
5
6See:
7- [HTTP referer](https://en.wikipedia.org/wiki/HTTP_referer) (Wikipedia)[](.html)
8- [Improve online privacy by controlling referrer information](http://www.ghacks.net/2015/01/22/improve-online-privacy-by-controlling-referrer-information/)[](.html)
9- [Better security, privacy and anonymity in Firefox](http://b.agilob.net/better-security-privacy-and-anonymity-in-firefox/)[](.html)
10
11### Firefox HTTP Referer options
12HTTP settings are available by browsing `about:config`, here are the available settings and their values.
13
14`network.http.sendRefererHeader` - determines when to send the Referer HTTP header
15- 0: Never send the referring URL
16 - not recommended, may break some sites
17- 1: Send only on clicked links
18- 2 (default): Send for links and images
19
20`network.http.referer.XOriginPolicy` - Cross-domain origin policy
21- 0 (default): Always send
22- 1: Send if base domains match
23- 2: Send if hosts match
24
25`network.http.referer.spoofSource` - Referer spoofing (~faking)
26- false (default): real referer
27- true: spoof referer (use target URI as referer)
28
29`network.http.referer.trimmingPolicy` - trim the URI not to send a full Referer
30- 0 (default): send full URI
31- 1: scheme+host+port+path
32- 2: scheme+host+port
33
34### Firefox, localhost and redirections
35`localhost` is not a proper Fully Qualified Domain Name (FQDN); if Firefox has been set up to spoof referers, or anly accept requests from the same base domain/host, Shaarli redirections will not work properly.
36
37To solve this, assign a local domain to your host, e.g.
38```
39127.0.0.1 localhost desktop localhost.lan
40::1 localhost desktop localhost.lan
41```
42
43and browse Shaarli at http://localhost.lan/.
44
45Related threads:
46- [What is localhost.localdomain for?](https://bbs.archlinux.org/viewtopic.php?id=156064)[](.html)
47- [Stop returning to the first page after editing a bookmark from another page](https://github.com/shaarli/Shaarli/issues/311)[](.html)
48
2## Login 49## Login
3### I forgot my password! 50### I forgot my password!
4
5Delete the file `data/config.php` and display the page again. You will be asked for a new login/password. 51Delete the file `data/config.php` and display the page again. You will be asked for a new login/password.
6 52
7### I'm locked out - Login bruteforce protection 53### I'm locked out - Login bruteforce protection
@@ -10,11 +56,11 @@ Login form is protected against brute force attacks: 4 failed logins will ban th
10To remove the current IP bans, delete the file `data/ipbans.php` 56To remove the current IP bans, delete the file `data/ipbans.php`
11 57
12### List of all login attempts 58### List of all login attempts
13
14The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans. 59The file `data/log.txt` shows all logins (successful or failed) and bans/lifted bans.
15Search for `failed` in this file to look for unauthorized login attempts. 60Search for `failed` in this file to look for unauthorized login attempts.
16 61
17## Hosting problems 62## Hosting problems
63### Old PHP versions
18 * On **free.fr** : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. Don't forget to create a `sessions` directory at the root of your webspace. Change the file extension to `.php5` or create a `.htaccess` file in the directory where Shaarli is located containing: 64 * On **free.fr** : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. Don't forget to create a `sessions` directory at the root of your webspace. Change the file extension to `.php5` or create a `.htaccess` file in the directory where Shaarli is located containing:
19 65
20```ini 66```ini
@@ -56,5 +102,4 @@ This can be caused by several things:
56Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have **no dots** in the hostname (e.g. `localhost` or `http://my-webserver/shaarli/`), some browsers will not store cookies at all (this respects the [HTTP cookie specification](http://curl.haxx.se/rfc/cookie_spec.html)).[](.html) 102Follow the instructions in the error message. Make sure you are accessing shaarli via a direct IP address or a proper hostname. If you have **no dots** in the hostname (e.g. `localhost` or `http://my-webserver/shaarli/`), some browsers will not store cookies at all (this respects the [HTTP cookie specification](http://curl.haxx.se/rfc/cookie_spec.html)).[](.html)
57 103
58### pubsubhubbub support 104### pubsubhubbub support
59
60Download [publisher.php](https://pubsubhubbub.googlecode.com/git/publisher_clients/php/library/publisher.php) at the root of your Shaarli installation and set `$GLOBALS['config'['PUBSUBHUB_URL']` in your `config.php`]('PUBSUBHUB_URL']`-in-your-`config.php`.html) 105Download [publisher.php](https://pubsubhubbub.googlecode.com/git/publisher_clients/php/library/publisher.php) at the root of your Shaarli installation and set `$GLOBALS['config'['PUBSUBHUB_URL']` in your `config.php`]('PUBSUBHUB_URL']`-in-your-`config.php`.html)