How to install TikiWiki.

Tags: installation upgrade active directory article upgrade


(3) Documentation » Installation

Installation

This page is part of the Basic Docs Project, and is currently being improved.

You don't have to be a web developer or programmer to install Tikiwiki. TikiWiki has an installer which will do most of the work for you, and the rest can be done from your control panel.

Free Installations: If you are a complete novice (or are just not into DIY) most Tiki friendly hosts will setup tiki for you free of charge.

Related pages:

Installation FAQ
Installation Problems- use this page to get help.
Installation Guides - recipes, tips and detailed knowledge about specific hosting environments
Migrate to Tikiwiki
Move Tiki to a new server
Multilingual Installation
Reinstall - to point tiki to a new Database or re-run an upgrade

Tiki in Ten minutes - a recipe for command line installations.
Install by FTP
Install by Fantastico? — an example of this is Siteground Installation
Using SSH (for newbies)
Manual Installation
MultiTiki
Upgrade

1. Basic overview in Tiki 3: Install and Profiles

This new installer and the application of the new set of Profiles is new in Tiki 3.0, and you can have a quick look at it in the following 12 min. screencast:

For more information on the Tiki installation process

Install Tiki Help is there for you if anything does not work right...
Database Performance and Tikiwiki Performance Tuning have tips to improve server performance

2. Step by step installation

Before You Begin

Before installing, please read the Requirements and Setup information. Proper planning can ensure a worry-free installation. If you are looking for a new webhost, we have a list of TikiFriendlyHosts. The instructions below are generic and apply to most shared hosts. See Installation Guides for instructions for specific combinations of operating system and web servers.

Pre-requisites

Before continuing,

A webserver (such as Apache) with PHP
A database (such as MySQL) (MySQL should be set NOT to use "strict mode" (if such an option is offered) to prevent problems - see this bug report)
A web browser (such as FireFox or IE)

Step 1. Create the database

-------
Tiki currently runs with MySQL and PostgreSQL, however, most of the documentation assumes you're using MySQL.

Many hosts offer a point & click interface to create databases and database users. For example, if your web host has cPanel (external link)

you probably can see phpMyAdmin (external link)

in the main menu or a the section labeled Databases.

The MySQL and phpMyAdmin applications in cPanel 11.

Creating a database (and a database user) is a very simple operation. Essentially you will create a blank (empty) database that the TikiWiki installer will later populate with the correct tables and data.

The Three steps of Database Setup.

Create a database.
- You can name the database anything you want, but don't get fancy with the name — you can use tiki. Depending on your web host, your full database in phpMyAdmin may be listed as accountname_tiki.
  Tip: If you plan on having multiple Tiki installations, don't use tiki as the database name.
- Be sure to write down the database name, you will need it later.
Create a database user (with password)
- Again, don't get fancy with the database username. In fact, you can use the same name that you selected for the database (in step 1).
- Select a strong password. You can easily recover your database username and password if necessary (by reviewing the ../db/local.php file in your TikiWiki directory.
- Be sure to write down the username and password. You will need it later.
Assign all database permissions to the database user that you created (in step 2).

Congratulations. You now have a database that is ready to use, as well a a database user (and password) with the necessary permissions.

See Create a database for TikiWiki for more information.

Step 2: Download

----
Download the current version of Tiki to you local computer from SourceForge (external link)

.

The full download is ~10MB.

Step 3: Upload

------
Decompress (unzip) the TikiWiki archive file that you downloaded, then move all the Tiki files to your web server. If you have a hosted web server, you can simply use FTP to move the files.

Be sure to write down the directory location to which you copied the files (such as http://www.yourdomain.com/tiki). This will be your TikiWiki home directory

Time for more coffee?

NOTE: For those of us that are not UNIX gurus "home directory" might be a bit confusing. Be advised that when you use a (sub)directory such as /tiki to put your TikiWiki files in then you seemingly are stuck having to use that (sub)directory name in your URL. I have been looking for some UNIX setup or path or preference file to negate that with no luck. Suffice it to say... If you are not putting up a Wiki for technical folks or a group that knows the entire URL, this might be extremely problematic. Hence, to have a user be able to just type in www.yourdomain.com (external link)

you have to put these files in the appropriate directory for your system/provider. For example: htdocs, httpdocs, or you may have to put the tiki files in your root directory.

Step 4: Go to your website.

-------
Open your browser and go to your new website address (such as http://www.yourdomain.com/tiki/. You should see a message indicating that TikiWiki could not connect to the database and prompting you to run the TikiWiki installer (tiki-install.php).

This message is normal and indicates that you are ready to install Tiki.

If a message appears indicating that specific directories are not writable, you will need to change the permissions on the indicated directories. TikiWiki will attempt to verify that it can read (and write) to all necessary directories.

After correcting any directory permission problems, click tiki-install to continue.

Step 5: Run the Tiki installer (tiki-install.php)

-------------
In English:
Open a web browser to: http://www.yourdomain.com/tiki-install.php

In other languages (since TikiWiki v1.9.7 onwards):
Open a web browser to: http://www.yourdomain.com/tiki-install.php?lang=XX

where XX is the language code of your preference, to have the interface in your language provided that it has beeen translated already.

Release 2.0 Release 1.9

!!!!# Database Connection

Enter your database name, username, and password. This is the information from the database that you created earlier. You did remember to write it down, right?

Be sure to update your PHP.INI file, as needed. See the Requirements and Setup information for more information.

1. Installation Profile

After submitting your database details, select which installation profile you would like to use for your Tiki site. A profile is a pre-configured set of options. See http://profiles.tikiwiki.org (external link)

for more information.

2. Review the Installation.

After Tiki populates the database, you should see this review screen:

Your database has been configured and Tiki is ready to run, if this is your first install your admin password is 'admin'. You can now log in into Tiki as 'admin' - 'admin' and start configuring the application.

At the bottom of the screen, there is additional, important information regarding the PHP configuration settings for your server and some final tips. Be sure to read the complete information, then select "Entering TikiWiki > Change the administrator password. Old password: admin"

3. Logging In

On your initial login to TikiWiki, you will be required to change the admin password:

Be sure to select a strong password.

Congratulations! Your TikiWiki is installed... you are done!

Keep reading the following pages of this documentation manual to see the next steps in order to set up and tune your new tiki site.

Alternative "Step 5" without tiki-install.php

Please see: Manual Installation

Step 6: Log in for the first time

--------
Log in using the login box in the right-hand column.

Enter those informations :
1. user: Enter admin.
2. pass: Enter admin.
Click login.

Step 7: Change the default password.

--------
Use a strong password. You may want to logout right away, and login again, letting your password manager record your password.

Step 8: Congratulations !

--------
It is recommended to create a new user and give him admin privileges instead of regularly using the admin account. You can now explore the interface but you should check the extra steps before to get you started.

Step 9: Configure Your TikiWiki

-------
Please visit Initial Configuration to explain the recommended next steps, or configuration for the table of contents replated to configuring tikiwiki.

Add new features through post-install Profiles (Tiki 3.x)

Starting in Tiki 3.0, you can enable several settings/permissions/content in sets altogether in a single go, in order to provide a common feature to your tiki site (make it multilingual, add freetags, configure it as a Collaborative environment, ...). And all that with a just few clicks through the Profile Manager from "Admin > Profiles".

Read more about it at Profiles.

3. For more information on the Tiki installation process...

--------------
You can check these specific pages: Installation FAQ, Installation Problems, Migrate to Tikiwiki or Upgrade, or just keep reading any of the following pages of this section of the documentation.

Contributors to this page: billr , ylavi , lindon , grovercalm , klang , luci , xavi , davidleasure , mlpvolt , marclaporte , ricks99 , mose , and system .
Page last modified on Saturday 27 June, 2009 06:53:52 UTC by billr .