1. Download

Download the package that best suits you:

 

Zanata Server: Easiest way to get Zanata up and running. Extract the contents of this file. The following steps will refer to this location as <ZANATA DIR>.

 

Zanata Web Archive: For more experienced users. You will need to provide a JBoss installation, configure it, and deploy Zanata manually.

2. Setup the Zanata Database

Zanata has been thoroughly tested against MySQL 5 so it's recommended that you install and use it with Zanata. You can download a copy Here.

 

Once you have installed the Database server, create a database schema for Zanata (make sure the default collation is UTF-8).

 

Now you only need to tell Zanata where to find this database. To do this, open the file:

 

<ZANATA DIR>/server/zanata/deploy/zanata-ds.xml

 

This file contains the database settings for Zanata. Modify the values for the following properties according to the database instance you have created for zanata. (If you are using MySQL as recommended, you will only need to change these):

 

connection-url This is the database location. By default it is configured to localhost, port 3306 and a schema named 'zanata'.

user-name Database user name. This user name should have full table creation permissions on the database instance.

password Database password.

3. Start Zanata

Starting zanata is as easy as running the 'start-zanata' executable found at

 

<ZANATA DIR>/bin/start-zanata.sh

 

... or for Windows users

 

<ZANATA DIR>/bin/start-zanata.bat

4. Start Using it!

Zanata should be available at

 

http://localhost:8080/zanata

 

By default, Zanata will have an 'admin' user with password 'admin'. Be sure to change this password when possible (don't say we didn't warn you).

 

For more information, check out our documentation section.

 

A few things to note:
Jboss 5 doesn't like being placed on a path with spaces.
Zanata requires an email (SMTP) server installed locally to perform certain notifications.