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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142

Zotonic installation
======================

You will need to:

1. Install Erlang 13B or newer. Build it from source, or
   use packages (see platform-specific notes below)

2. Install ImageMagick (version 6.5 or higher) for the 'convert' and
   'identify' tools.  Make sure that the convert and identify tools
   are in your path so that zotonic can find them. For auto-rotation
   to work you'll need the "exif" utility as well.

3. Install PostgreSQL (preferably 8.3 or newer).

4. Enable trust-authentication (username+password) in postgres.

5. Obtain a copy of the Zotonic source code.




Steps to install Zotonic
------------------------

1. Type "make" in the root of zotonic (there where the Makefile is located). (*1)

2. Create an user and database in PostgreSQL (change the password for the user!):

   CREATE USER zotonic WITH PASSWORD 'zotonic';
   CREATE DATABASE zotonic WITH OWNER = zotonic ENCODING = 'UTF8';
   GRANT ALL ON DATABASE zotonic TO zotonic;
   \c zotonic
   CREATE LANGUAGE "plpgsql";

3. Create a new zotonic site, based on the "blog" skeleton site:

   bin/zotonic addsite -s blog yoursite

   This will add a site named yoursite. Its default URL will be
   http://yoursite:8000/ so either put 'yoursite' in your hosts
   file or change the {hostname} section of the config file.

4. Edit the generated file priv/sites/yoursite/config, to make sure
   your database credentials and the hostname are correct, and change
   the password for the admin.

5. Start zotonic in debug mode:

   bin/zotonic debug

7. You see zotonic starting up, lots of messages pass by, and zotonic
   will install the initial database.  When something goes wrong here,
   then it is almost always a problem with the database
   connection. Check your database configuration in the zotonic.sh
   file.

8. Point your browser to 
	
    http://yoursite:8000/
	
   or logon as user 'admin' (the default password is 'admin') at:

    http://yoursite:8000/admin/

9. When all done, then you can stop the erlang shell with:

    q().

   or pressing ctrl-c twice.



Operating system specific notes:
-------------------------------

FreeBSD:
-------
If you're running on FreeBSD, make sure you've got the 'GNU' 'make'
(check with 'make --version', which should give you GNU, and version
info) If you're not running GNU-make as a default, edit the Makefile
to run with 'gmake' (make sure gmake is available first))



Ubuntu 9.04 (jaunty)
--------------------

You'll need to build erlang from source. Before building, make sure
you install these packages:

sudo apt-get install build-essential unixodbc-dev libncurses-dev libssl-dev libxml2-dev libexpat1-dev

PostgreSQL and Imagemagick are available on Ubuntu as packages:

sudo apt-get install postgresql-8.4 imagemagick


Ubuntu 9.10 (karmic)
--------------------
Follow the instructions for Ubuntu 9.04, but instead of compiling
erlang, you can just install Erlang but you need the ssl and xml dev
libraries as well for XMPP:

sudo apt-get install erlang build-essential libxml2-dev libexpat1-dev


Debian (lenny)
--------------------
You'll need to build erlang from source. Before building, make sure
you install these packages:

sudo apt-get install build-essential libncurses5-dev m4
sudo apt-get install openssl libssl-dev
sudo apt-get install unixodbc-dev


Windows
-------
Currently, Zotonic is not officially supported on the Windows
platform. However, the main dependencies Erlang, PostgreSQL and
ImageMagick do work on Windows, so, if you're adventurous, it should
be possible to get it running.

We have included user-contributed "start.cmd" and "build.cmd"
batch-scripts which are supposed to work on Windows.


Mac OS X
--------

With MacPorts you can install Erlang and ImageMagick using the
following commands:

  sudo port install erlang +ssl
  sudo port install ImageMagick

EnterpriseDB has an excellent PostgreSQL installer available at
http://www.enterprisedb.com/products/pgdownload.do#osx

For a very basic step-by-step installation on OSX, chick this
http://timbenniks.nl/blog/712/step-by-step-guide-to-install-zotonic-on-osx.