# Installation

You don't have to be a web developer or programmer to install Tiki. Tiki has an easy-to-use, wizard-based installer which will do most of the work for you. The rest can be completed from your webhost's control panel. You can also use 1-click installers.

If you are a complete novice (or are just not into DIY = do it yourself ) consider using Tiki friendly hosts. Many will complete your Tiki setup you free of charge.

# Overview

These videos offer an basic overview of Tiki installation. See Tiki TV and Tiki Movies for additional videos.

From Tiki for Dummies Smarties

# Step by step installation

## Before You Begin

Before installing Tiki, read the Requirements and Setup information and use the Server Check tool. Proper planning can ensure a worry-free installation. If you need a webhost for your Tiki, refer to the list of Tiki Friendly Hosts.

These instructions are intentionally generic, and should apply to most shared host installations. See Installation Guides for instructions for specific combination of operating system and web servers.

### Pre-requisites

This guide assumes you have:
• FTP or SSH (shell) access to a webserver (such as Apache) with PHP5
• Typically, you upload the files via a FTP client such as WinSCP or FileZilla.

## 1. Create the database

Tiki requires a MySQL databse.

Many hosts offer a point & click interface to create databases and database users. For example, if your web host has cPanel you probably can see phpMyAdmin 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 Tiki installer will later populate with the correct tables and data.

#### The Three steps of Database Setup.

1. 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.
Note: By default, Tiki uses UTF-8 for your database encoding. We strongly encourage you to select "utf8" in the "collation" drop-down box in phpmyadmin (or similar), in the field shown in the following image:

If you select a different encoding method, you may need to manually update your ../db/local.php file.
Tip: If you plan on having multiple Tiki installations, don't use tiki as the database name.
• Be sure to record the database name, you will need it later.
2. 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 Tiki directory.
• Be sure to record the username and password. You will need it later.
3. 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.

From Tiki for Dummies Smarties

The full Tiki archive file download is 20-50MB depending on the version and compression (zip, bz2, etc,).

Use FTP (or SCP, SFTP, Rsync, SSH, etc) to connect to your webhost.

Once connected, find your web directory. It is often called www or public_html.
Note: This directory name may vary, depending on your webhost.

• If you upload the Tiki files to the root of your web directory, Tiki will be accessible directly from the URL: http://www.yourdomain.com
• If you have installed (or plan to install) other applications on your webhost, you may consider putting Tiki in its own subdirectory (for example: http://www.yourdomain.com/tiki/). Keep in mind that this might mean that you will have to manually edit the file .htaccess to activate the Tiki subdirectory (for example this "RewriteRule ^(.+)$/tiki-index.php?page=$1 [QSA,L]" might need to become this "RewriteRule ^(.+)$/tiki/tiki-index.php?page=$1 [QSA,L]")

### 3.1. Example: Installation with lftp

lftp -u username ftp.example.com
lcd /path/to/local/tiki
cd /path/to/web/tiki
set ftp:ssl-allow no
mirror -R ./

A ftp testing upload session to an external webhoster needed approximately two hours, and the limitation was the provider's setting. The local internet connection was not saturated.
Time for more coffee?

## 4. Go to your website.

Open your web browser and access the web directory in which you copied the Tiki files (for example: http://www.yourdomain.com/tiki/ or simply http://www.yourdomain.com if you copied Tiki to the root of your web directory.

The Tiki Installer Welcome screen appears.

From Tiki for Dummies Smarties

The Tiki Installer includes important links to the ReleaseNotes and Documentation. Be sure to review these documents before installing Tiki.

### 4.1. Troubleshooting

2012-09: A new Server Check script has been developed that will make everything easier! Just upload a single PHP file to your server and you will get advice on your server configuration.

If your browser returns an error such as Parse error: syntax error, unexpected T_STRING, you may have the incorrect PHP version.

Starting with Tiki 3.0, Tiki requires PHP5. Review the _htaccess file included in the Tiki archive file for instructions on activating PHP5.

See the Installation FAQs for more help.

### 1. File and Folder permissions

If your server is unhappy with Tiki file and folder permissions (this is dependent on server configuration), you may get an error message or blank pages. These failed attempts are typically in the error log (ask your web host to know where they are as it's different depending of your setup)

Too few permissions
If a message appears indicating that specific directories are not writable, you will need to change the permissions on the indicated directories. Tiki will attempt to verify that it can read (and write) to all necessary directories. This error message will include instructions about how to resolve the issue.

Too many permissions
If you are getting Internal Server Error 500, blank pages or similar, it could be that the permissions on the files are not appropriate for your webhost.

If your permissions are currently at "777", use your FTP client to change the files to "755". If Tiki is installed in a directory, make sure to also change the permission of the folder which contains the tiki files.

If you have shell access, you can run:
sh setup.sh

and answer any questions. If you don't know what to answer, just click "enter" to keep the defaults.

If "sh setup.sh" doesn't work for you, you may try, in your ./tiki/ directory
chmod -R 777 ./db ./dump ./img/wiki ./img/wiki_up ./img/trackers ./modules/cache ./temp ./temp/cache ./templates_c ./templates ./styles ./whelp/

Another way is to set permissions for all directories and then set permissions for all files. For example, to set the permissions for all directories to 777 and the permissions for all files to 644, use the following separate commands through shell access:
find [YOURDIR] -type d -exec chmod 777 {} \;

find [YOURDIR] -type f -exec chmod 644 {} \;

After correcting any directory or file permission problems, visit tiki-install.php to continue.

### 2. SuPHP Problems

Systems with SuPHP need permissions 755 at maximum. Group must not be allowed to write. This includes the complete path in the filesystem, not only document root of the webserver. Wrong permissions may lead to 500 Internal Server Error here. On the other hand less permissions (namely 750 without x/execute/subdir entry for webserver) may lead to 403 Forbidden Error.

### 3. Permission Matrix

Several usecases and minimum to maximum permissions you may try if something doesn't work properly. Permissions refer to data directly accessed by the webserver (files included by Tiki itself may and should have less permissions):
 Ownershipusername:groupname no SuPHPfiles / subdirectories with SuPHPfiles / subdirectories webserver:webserver 600 - 666 / 700 - 777 ? user:user 604 - 666 / 705 - 777 600 - 644 / 701 - 755 user:webserver 660 - 666 / 770 - 777 ? webserver:user 660 - 666 / 770 - 777 ?

#### 3.1. Option

find . -type d -exec chmod 755 {} \; ; chmod 755 . ; find . -type f -exec chmod 755 {} \; ; chmod 751 db/local.php

#### 3.2. Option

The following commands might be useful. In particular, it might help you use an IDE (PhpStorm), etc:
$export PathToTiki="/var/www/tiki"$ export WebServerOwner="www-data"
$sudo usermod -aG${WebServerOwner} $(whoami)$ sudo chown -R ${WebServerOwner}:${PathToTiki}
$sudo chmod -R g+rw${PathToTiki}

In English, the above code adds you to the web-server group; forces the tiki tree to be owned by the web-server user and group; and then makes sure the tiki tree is readable and writable by the web-server group (you). Suggestions welcome!

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

Open a web browser to: http://www.yourdomain.com/tiki-install.php (or http://www.yourdomain.com/tiki/tiki-install.php if you installed Tiki in a subdirectory).

The first page of the Tiki Installer appears. This installer will allow you to:
• Pick a language
• If the installer detects that some of your server settings are inadequate, it will suggest changes to comply to the requirements.
This is the information from the database that you created earlier. You did remember to write it down, right? For non-default port number use syntax "example.com;port=3307"
• Create/update the database
• Note: on osx installations, the mysql socket is a bit different. In /etc/php.ini, change all instances of /var/mysql/mysql.sock to /tmp/mysql.sock and then restart the web server
• Set some preferences, such as admin email
• Disable the install script
• and more

Complete each page of the Tiki Installer.

### Alternative "Step 5" without tiki-install.php

If you are unable to complete the Tiki Installer, continue with a Manual Installation.

1. Enter those informations :

## 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.

### Add new features through post-install Profiles

Starting in Tiki3, 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".

Related pages:
 Installation FAQ Installation Guides - recipes, tips and detailed knowledge about specific hosting environments Migrate to Tikiwiki Move Tiki to a new server Reinstall - to point tiki to a new Database or re-run an upgrade Tiki in Ten minutes - a recipe for command line installations. Fantastico Installation Using SSH (for newbies) Manual Installation MultiTiki

Alias

### Keywords

These keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):