1 [[meta title="Mirroring the web site"]]
3 In keeping with the philosophy of distributed development, our web site is
4 stored in our git repositories and converted into html by
5 [ikiwiki](http://ikiwiki.info/).
7 We're mirrored on several servers. Rather than using ikiwiki's [pinger/pingee
8 approach to distribution](http://ikiwiki.info/tips/distributed_wikis/), we've
9 opted for a method that uses ssh.
11 ## Initial steps to take on the mirror server ##
13 Add etch-backports to your /etc/apt/sources.list:
15 deb http://www.backports.org/debian etch-backports main contrib non-free
17 Add the following lines to your /etc/apt/preferences file:
20 Pin: release a=etch-backports
24 Package: libcgi-formbuilder-perl
25 Pin: release a=etch-backports
29 Pin: release a=etch-backports
32 Install git-core and ikiwiki
34 aptitude update; aptitutde install git-core ikiwiki
36 Create a new user. Change the new users shell to git-shell:
38 adduser -s /usr/bin/git-shell <username>
40 Add webmaster@george's public key to this user's ~/.ssh/authorized_keys file
42 Add web site configuration that the user has write access to. If you are using Apache, include the following rewrite:
45 RewriteCond %{HTTP_HOST} !^(YOURHOSTNAME|web)\.monkeysphere\.info$ [NC]
46 RewriteCond %{HTTP_HOST} !^$
47 RewriteRule ^/(.*) http://web.monkeysphere.info/$1 [L,R]
49 Upload and edit ikiwiki.setup.sample from the docs directory
51 As the new user, create a git repo
53 mkdir monkeysphere.git; cd monkeysphere.git; git init --bare;
56 ## Initial Admin steps to take to enable the configuration ##
58 Add a new dns record for SERVERNAME.monkeysphere.info.
60 Test the ssh connection by logging in as webmaster@george.riseup.net
62 Add the new server as a remote on webmaster@george.riseup.net:monkeysphere.git
65 git add remote SERVERNAME USER@SERVERNAME.monkeysphere.info:/path/to/repo
67 Modify ~/monkeysphere.git/config, so the new repo stanza looks like this:
70 url = USER@SERVERNAME.monkeysphere.info:monkeysphere.git
71 push = +refs/heads/master
72 skipDefaultUpdate = true
79 ## Final steps to take on mirror server ##
81 At this point, you should have a populated git repo in your
82 monkeyshere.git directory.
84 Change the mode of monkeysphere.git/hooks/post-receive to 755
86 chmod 755 monkesphere.git/hooks/post-receive
88 Edit the file so that it executes the post-receive hook ikiwiki generates (as
89 you specified in the ikiwiki.setup file)
91 Next, clone the repository:
93 clone monkeysphere.git monkeysphere
95 And lastly, run ikiwiki manually to generate the post-receive hook:
97 ikiwiki --setup ikiwiki.setup