aboutsummaryrefslogtreecommitdiff
path: root/doc/forum/can__39__t_connect_to_local_url_after_installing_ikiwiki/comment_1_9feba07c25d226bf63d0886139ed7847._comment
blob: b1689e1c7270e82268a7f427275a86bbae203b4f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
[[!comment format=mdwn
 username="smcv"
 subject="You'll need a web server, and don't run ikiwiki as root"
 date="2016-03-11T20:39:35Z"
 content="""
> sudo ikiwiki --setup /opt/local/etc/ikiwiki/auto.setup

This is probably not the cause of your problem, but please don't do this. ikiwiki
should always be run as an ordinary user, never as root. If it runs as root, any
bugs in ikiwiki could have very bad consequences.

(I'm tempted to make it just exit with an error message if run as root, actually.)

> ```
>     url:         http://kund-Mac-2.local/~root/RelatiicuPublicul
>     srcdir:      ~/RelatiicuPublicul
>     destdir:     ~/public_html/RelatiicuPublicul
>     repository:  ~/RelatiicuPublicul.git
> ```

ikiwiki does not include a web server (http server), so you cannot edit via a
browser without providing one.

`auto.setup` tries to guess at some reasonable defaults that will work on a
reasonable number of Unix machines: it assumes that `~/public_html` is
mapped to `http://${hostname}/~${username}/` by your web server. This is
the default configuration on many Linux and *BSD systems; I don't know
whether that's true on OS X or not.

It also assumes that an executable named `ikiwiki.cgi` in `public_html`
will be run as a CGI script. Again, this is often true, but not always.

Perhaps we should have some wording like

```
If you have a web server running, your site might be available at:

     url:         http://kund-Mac-2.local/~root/RelatiicuPublicul
     srcdir:      ~/RelatiicuPublicul
     destdir:     ~/public_html/RelatiicuPublicul
     repository:  ~/RelatiicuPublicul.git
```

as a hint that ikiwiki has done what it can, and the rest is up to you?

> Unescaped left brace in regex is deprecated

I think we fixed this in the latest version of ikiwiki, so you might not
be running the current version (that won't affect this particular
issue, but there are other improvements).
"""]]