Edit page geeki/install
[wiki.git] / geeki / install
diff --git a/geeki/install b/geeki/install
new file mode 100644 (file)
index 0000000..152ec38
--- /dev/null
@@ -0,0 +1,38 @@
+== Easy installation ==
+
+The easiest installation procedure is:
+
+ * clone the git repository of GeekiGeeki anywhere you like:
+ {{{
+ cd public_html
+ git clone git://codewiz.org/~bernie/geekigeeki.git wiki
+ cd wiki
+ }}}
+
+ * edit ##wiki_apache.conf## to adapt it to your system, then move or symlink it to your Apache configuration directory
+ * customize your wiki instance by editing ##geekigeeki.conf.py##
+ * populate an initial git repository for your wiki:
+ {{{
+  git clone --shared git://codewiz.org/~bernie/geekigeeki_data.git data
+  chgrp -R apache data
+ }}}
+ The last command is necessary to let the web server write in the directory.
+ Debian-based distributions use ##www-data## instead of ##apache##.  OpenSUSE
+ uses ##www##.
+ * reload or restart the web server
+
+== Update procedure ==
+
+If you cloned the repository as suggested, updating and downgrading is easy:
+
+{{{
+git pull
+}}}
+
+to switch to a different version of GeekiGeeki:
+
+{{{
+git checkout {tree-ish}
+}}}
+
+where '##{tree-ish}## could be a tag, a branch name, or a specific commit.