aboutsummaryrefslogtreecommitdiff
path: root/INSTALL.md
blob: 8d50ddbd7d01c1c9bed09625df865dede8e47cc6 (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
52
53
54
55
56
57
58
Installing Ratatöskr
====================

Step 0: Requirements
--------------------

* Apache Webserver with PHP 5.3
* These PHP modules (usually installed): gd, hash, session, mysql
* A MySQL server.

Step 1: Get additional libraries
--------------------------------

You need these libraries to run Ratatöskr (it is probably already bundled with these):

1. Stupid Template Engine (STE)
   
   Place "stupid_template_engine.php" directly into this directory.
   
   STE can be found here: <https://github.com/kch42/Stupid-Template-Engine>

2. PHP Markdown
   
   Place "markdown.php" from the archive directly into this directory.
   
   PHP Markdown can be found here: <http://michelf.com/projects/php-markdown/>

3. kses
   
   Place "kses.php" from the archive directly into this directory.
   
   kses can be found at <http://sourceforge.net/projects/kses/>

Step 2: Copy files to your Webspace
-----------------------------------

Copy Ratatöskr to your webspace (usually using FTP or SFTP).

Step 3: Use the setup wizard
----------------------------

1. Open your favourite Web browser and surf to `setup.php` of your Ratatöskr installation.

2. * If the wizard is complaining about some unmet requirements, your server is probably not capable of running Ratatöskr. Sorry :-(.
   * If the wizard is complaining about missing directories, create them.
   * If the wizard is complaining about missing files, check, if you uploaded everything.
   * If the wizard is complaining about missing writing permissions, give the Webserver writing permissions to these directories.

3. Choose your language.

4. Enter the MySQL connection details and the desired username and password for the admin account.

5. Copy the text from the textbox and replace the contents of `/ratatoeskr/config.php` with it.

Step 4: Delete the setup wizard
-------------------------------

Delete the file `setup.php`.