generated
[privoxy.git] / doc / webserver / user-manual / quickstart.html
1 <HTML
2 ><HEAD
3 ><TITLE
4 >Quickstart to Using Privoxy</TITLE
5 ><META
6 NAME="GENERATOR"
7 CONTENT="Modular DocBook HTML Stylesheet Version 1.60"><LINK
8 REL="HOME"
9 TITLE="Privoxy User Manual"
10 HREF="index.html"><LINK
11 REL="PREVIOUS"
12 TITLE="Note to Upgraders"
13 HREF="upgradersnote.html"><LINK
14 REL="NEXT"
15 TITLE="Starting Privoxy"
16 HREF="startup.html"><LINK
17 REL="STYLESHEET"
18 TYPE="text/css"
19 HREF="../p_doc.css"></HEAD
20 ><BODY
21 CLASS="SECT1"
22 BGCOLOR="#EEEEEE"
23 TEXT="#000000"
24 LINK="#0000FF"
25 VLINK="#840084"
26 ALINK="#0000FF"
27 ><DIV
28 CLASS="NAVHEADER"
29 ><TABLE
30 WIDTH="100%"
31 BORDER="0"
32 CELLPADDING="0"
33 CELLSPACING="0"
34 ><TR
35 ><TH
36 COLSPAN="3"
37 ALIGN="center"
38 >Privoxy User Manual</TH
39 ></TR
40 ><TR
41 ><TD
42 WIDTH="10%"
43 ALIGN="left"
44 VALIGN="bottom"
45 ><A
46 HREF="upgradersnote.html"
47 >Prev</A
48 ></TD
49 ><TD
50 WIDTH="80%"
51 ALIGN="center"
52 VALIGN="bottom"
53 ></TD
54 ><TD
55 WIDTH="10%"
56 ALIGN="right"
57 VALIGN="bottom"
58 ><A
59 HREF="startup.html"
60 >Next</A
61 ></TD
62 ></TR
63 ></TABLE
64 ><HR
65 ALIGN="LEFT"
66 WIDTH="100%"></DIV
67 ><DIV
68 CLASS="SECT1"
69 ><H1
70 CLASS="SECT1"
71 ><A
72 NAME="QUICKSTART"
73 >4. Quickstart to Using <SPAN
74 CLASS="APPLICATION"
75 >Privoxy</SPAN
76 ></A
77 ></H1
78 ><P
79 > <P
80 ></P
81 ><UL
82 ><LI
83 ><P
84 >   If upgrading, from versions before 2.9.16, please back up any configuration
85    files. See the <A
86 HREF="upgradersnote.html"
87 >Note to Upgraders</A
88 > Section.
89  </P
90 ></LI
91 ><LI
92 ><P
93 >  Install <SPAN
94 CLASS="APPLICATION"
95 >Privoxy</SPAN
96 >. See the <A
97 HREF="installation.html"
98 >Installation Section</A
99 > below for platform specific
100   information. 
101  </P
102 ></LI
103 ><LI
104 ><P
105 >   Advanced users and those who want to offer <SPAN
106 CLASS="APPLICATION"
107 >Privoxy</SPAN
108 >
109    service to more than just their local machine should check the <A
110 HREF="config.html"
111 >main config file</A
112 >, especially the <A
113 HREF="config.html#ACCESS-CONTROL"
114 >security-relevant</A
115 > options. These are 
116    off by default.
117   </P
118 ></LI
119 ><LI
120 ><P
121 >  Start <SPAN
122 CLASS="APPLICATION"
123 >Privoxy</SPAN
124 >, if the installation program has
125   not done this already (may vary according to platform). See the section
126   <A
127 HREF="startup.html"
128 >Starting <SPAN
129 CLASS="APPLICATION"
130 >Privoxy</SPAN
131 ></A
132 >.
133   </P
134 ></LI
135 ><LI
136 ><P
137 >   Set your browser to use <SPAN
138 CLASS="APPLICATION"
139 >Privoxy</SPAN
140 > as HTTP and
141    HTTPS proxy by setting the proxy configuration for address of
142    <TT
143 CLASS="LITERAL"
144 >127.0.0.1</TT
145 > and port <TT
146 CLASS="LITERAL"
147 >8118</TT
148 >.
149    (<SPAN
150 CLASS="APPLICATION"
151 >Junkbuster</SPAN
152 > and earlier versions of
153    <SPAN
154 CLASS="APPLICATION"
155 >Privoxy</SPAN
156 > used port 8000.) See the section <A
157 HREF="startup.html"
158 >Starting <SPAN
159 CLASS="APPLICATION"
160 >Privoxy</SPAN
161 ></A
162 > below
163    for more details on this.
164   </P
165 ></LI
166 ><LI
167 ><P
168 >    Flush your browser's disk and memory caches, to remove any cached ad images.
169   </P
170 ></LI
171 ><LI
172 ><P
173 >   A default installation should provide a reasonable starting point for 
174    most. There will undoubtedly be occasions where you will want to adjust the
175    configuration, but that can be dealt with as the need arises. Little 
176    to no initial configuration is required in most cases.
177   </P
178 ><P
179 >   See the <A
180 HREF="configuration.html"
181 >Configuration section</A
182 > for more
183    configuration options, and how to customize your installation.
184  
185   </P
186 ></LI
187 ><LI
188 ><P
189 >    If you experience ads that slipped through, innocent images that are
190     blocked, or otherwise feel the need to fine-tune
191     <SPAN
192 CLASS="APPLICATION"
193 >Privoxy's</SPAN
194 > behaviour, take a look at the <A
195 HREF="actions-file.html"
196 >actions files</A
197 >. As a quick start, you might
198     find the <A
199 HREF="actions-file.html#ACT-EXAMPLES"
200 >richly commented examples</A
201 >
202     helpful. You can also view and edit the actions files through the <A
203 HREF="http://config.privoxy.org"
204 TARGET="_top"
205 >web-based user interface</A
206 >. The
207     Appendix <SPAN
208 CLASS="QUOTE"
209 >"<A
210 HREF="appendix.html#ACTIONSANAT"
211 >Anatomy of an
212     Action</A
213 >"</SPAN
214 > has hints how to debug actions that
215     <SPAN
216 CLASS="QUOTE"
217 >"misbehave"</SPAN
218 >.
219   </P
220 ></LI
221 ><LI
222 ><P
223 >   Please see the section <A
224 HREF="contact.html"
225 >Contacting the
226    Developers</A
227 > on how to report bugs or problems with websites or to get
228    help. 
229   </P
230 ></LI
231 ><LI
232 ><P
233 >   Now enjoy surfing with enhanced comfort and privacy!
234   </P
235 ></LI
236 ></UL
237 ></P
238 ></DIV
239 ><DIV
240 CLASS="NAVFOOTER"
241 ><HR
242 ALIGN="LEFT"
243 WIDTH="100%"><TABLE
244 WIDTH="100%"
245 BORDER="0"
246 CELLPADDING="0"
247 CELLSPACING="0"
248 ><TR
249 ><TD
250 WIDTH="33%"
251 ALIGN="left"
252 VALIGN="top"
253 ><A
254 HREF="upgradersnote.html"
255 >Prev</A
256 ></TD
257 ><TD
258 WIDTH="34%"
259 ALIGN="center"
260 VALIGN="top"
261 ><A
262 HREF="index.html"
263 >Home</A
264 ></TD
265 ><TD
266 WIDTH="33%"
267 ALIGN="right"
268 VALIGN="top"
269 ><A
270 HREF="startup.html"
271 >Next</A
272 ></TD
273 ></TR
274 ><TR
275 ><TD
276 WIDTH="33%"
277 ALIGN="left"
278 VALIGN="top"
279 >Note to Upgraders</TD
280 ><TD
281 WIDTH="34%"
282 ALIGN="center"
283 VALIGN="top"
284 >&nbsp;</TD
285 ><TD
286 WIDTH="33%"
287 ALIGN="right"
288 VALIGN="top"
289 >Starting <SPAN
290 CLASS="APPLICATION"
291 >Privoxy</SPAN
292 ></TD
293 ></TR
294 ></TABLE
295 ></DIV
296 ></BODY
297 ></HTML
298 >