aboutsummaryrefslogtreecommitdiffhomepage
path: root/doc/Troubleshooting.html
diff options
context:
space:
mode:
Diffstat (limited to 'doc/Troubleshooting.html')
-rw-r--r--doc/Troubleshooting.html50
1 files changed, 50 insertions, 0 deletions
diff --git a/doc/Troubleshooting.html b/doc/Troubleshooting.html
index 6965a578..00cfdff8 100644
--- a/doc/Troubleshooting.html
+++ b/doc/Troubleshooting.html
@@ -51,6 +51,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
51<li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li> 51<li><a href="Backup,-restore,-import-and-export.html">Backup, restore, import and export</a></li>
52<li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li> 52<li><a href="Copy-an-existing-installation-over-SSH-and-serve-it-locally.html">Copy an existing installation over SSH and serve it locally</a></li>
53<li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li> 53<li><a href="Download-CSS-styles-from-an-OPML-list.html">Download CSS styles from an OPML list</a></li>
54<li><a href="Datastore-hacks.html">Datastore hacks</a></li>
54</ul></li> 55</ul></li>
55<li><a href="Troubleshooting.html">Troubleshooting</a></li> 56<li><a href="Troubleshooting.html">Troubleshooting</a></li>
56<li><a href="Development.html">Development</a> 57<li><a href="Development.html">Development</a>
@@ -74,6 +75,54 @@ code > span.er { color: #ff0000; font-weight: bold; }
74</ul> 75</ul>
75</div> 76</div>
76<h1 id="troubleshooting">Troubleshooting</h1> 77<h1 id="troubleshooting">Troubleshooting</h1>
78<h2 id="browser">Browser</h2>
79<h3 id="redirection-issues-http-referer">Redirection issues (HTTP Referer)</h3>
80<p>Depending on its configuration and installed plugins, the browser may remove or alter (spoof) HTTP referers, thus preventing Shaarli from properly redirecting between pages.</p>
81<p>See:</p>
82<ul>
83<li><a href="https://en.wikipedia.org/wiki/HTTP_referer">HTTP referer</a> (Wikipedia)<a href=".html"></a></li>
84<li><a href="http://www.ghacks.net/2015/01/22/improve-online-privacy-by-controlling-referrer-information/">Improve online privacy by controlling referrer information</a><a href=".html"></a></li>
85<li><a href="http://b.agilob.net/better-security-privacy-and-anonymity-in-firefox/">Better security, privacy and anonymity in Firefox</a><a href=".html"></a></li>
86</ul>
87<h3 id="firefox-http-referer-options">Firefox HTTP Referer options</h3>
88<p>HTTP settings are available by browsing <code>about:config</code>, here are the available settings and their values.</p>
89<p><code>network.http.sendRefererHeader</code> - determines when to send the Referer HTTP header</p>
90<ul>
91<li>0: Never send the referring URL
92<ul>
93<li>not recommended, may break some sites</li>
94</ul></li>
95<li>1: Send only on clicked links</li>
96<li>2 (default): Send for links and images</li>
97</ul>
98<p><code>network.http.referer.XOriginPolicy</code> - Cross-domain origin policy</p>
99<ul>
100<li>0 (default): Always send</li>
101<li>1: Send if base domains match</li>
102<li>2: Send if hosts match</li>
103</ul>
104<p><code>network.http.referer.spoofSource</code> - Referer spoofing (~faking)</p>
105<ul>
106<li>false (default): real referer</li>
107<li>true: spoof referer (use target URI as referer)</li>
108</ul>
109<p><code>network.http.referer.trimmingPolicy</code> - trim the URI not to send a full Referer</p>
110<ul>
111<li>0 (default): send full URI</li>
112<li>1: scheme+host+port+path</li>
113<li>2: scheme+host+port</li>
114</ul>
115<h3 id="firefox-localhost-and-redirections">Firefox, localhost and redirections</h3>
116<p><code>localhost</code> 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.</p>
117<p>To solve this, assign a local domain to your host, e.g.</p>
118<pre><code>127.0.0.1 localhost desktop localhost.lan
119::1 localhost desktop localhost.lan</code></pre>
120<p>and browse Shaarli at <a href="http://localhost.lan/" class="uri">http://localhost.lan/</a>.</p>
121<p>Related threads:</p>
122<ul>
123<li><a href="https://bbs.archlinux.org/viewtopic.php?id=156064">What is localhost.localdomain for?</a><a href=".html"></a></li>
124<li><a href="https://github.com/shaarli/Shaarli/issues/311">Stop returning to the first page after editing a bookmark from another page</a><a href=".html"></a></li>
125</ul>
77<h2 id="login">Login</h2> 126<h2 id="login">Login</h2>
78<h3 id="i-forgot-my-password">I forgot my password!</h3> 127<h3 id="i-forgot-my-password">I forgot my password!</h3>
79<p>Delete the file <code>data/config.php</code> and display the page again. You will be asked for a new login/password.</p> 128<p>Delete the file <code>data/config.php</code> and display the page again. You will be asked for a new login/password.</p>
@@ -83,6 +132,7 @@ code > span.er { color: #ff0000; font-weight: bold; }
83<h3 id="list-of-all-login-attempts">List of all login attempts</h3> 132<h3 id="list-of-all-login-attempts">List of all login attempts</h3>
84<p>The file <code>data/log.txt</code> shows all logins (successful or failed) and bans/lifted bans.<br />Search for <code>failed</code> in this file to look for unauthorized login attempts.</p> 133<p>The file <code>data/log.txt</code> shows all logins (successful or failed) and bans/lifted bans.<br />Search for <code>failed</code> in this file to look for unauthorized login attempts.</p>
85<h2 id="hosting-problems">Hosting problems</h2> 134<h2 id="hosting-problems">Hosting problems</h2>
135<h3 id="old-php-versions">Old PHP versions</h3>
86<ul> 136<ul>
87<li>On <strong>free.fr</strong> : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. Don't forget to create a <code>sessions</code> directory at the root of your webspace. Change the file extension to <code>.php5</code> or create a <code>.htaccess</code> file in the directory where Shaarli is located containing:</li> 137<li>On <strong>free.fr</strong> : Please note that free uses php 5.1 and thus you will not have autocomplete in tag editing. Don't forget to create a <code>sessions</code> directory at the root of your webspace. Change the file extension to <code>.php5</code> or create a <code>.htaccess</code> file in the directory where Shaarli is located containing:</li>
88</ul> 138</ul>