How to install and configure PHP-Nuke in Ubuntu Desktop

This is a guide on how to install and configure PHP-Nuke 8.0 in Ubuntu. PHP-Nuke is a Content Management System used by many organizations and individuals as a platform for their website, blog or forum in the Internet.

To setup PHP-Nuke on your Ubuntu Desktop operating system, first, you need a web server and database server. If you haven't install it, the easiest way is to install LAMP server. When you are ready, follow the step by step instruction below to begin setup PHP-Nuke.

1) Download PHP-Nuke from official website: Professional Content Management System - Official Website

2) Unzip PHP-Nuke zip file and copy the extracted file to the web server root directory(/var/www/).

[email protected]:~$ sudo su
[sudo] password for kkcjlab:
[email protected]:/home/kkcjlab# cd
[email protected]:~# cp -r /home/kkcjlab/Desktop/PHP-Nuke-8.0 /var/www/
[email protected]:~# cd /var/www/
[email protected]:/var/www# ls -l
total 28
-rw-r--r-- 1 root root 45 2009-09-10 08:10 index.html
drwxr-xr-x 16 www-data www-data 4096 2009-10-20 13:13 joomla-basic
drwxr-xr-x 6 kkcjlab kkcjlab 4096 2009-12-08 14:19 lapor-kerosakan
drwxr-xr-x 5 root root 4096 2010-04-21 11:27 PHP-Nuke-8.0

3) Change PHP-Nuke-8.0 directory name to your website name. See example below:

[email protected]:/var/www# mv PHP-Nuke-8.0/ mufti

3) Now you can configure PHP-Nuke using the web browser. That's the easiest way. Open a web browser and type your web server address. For example, if you are using a local web server, the address would be something like: http://localhost/mufti/. Change the name 'mufti' to your website name as in the step 3 above.

PHP-Nuke installation setup image

4) Click 'HTML' to begin setup PHP-Nuke website. You should get a page similar to example below:

Begin PHP-Nuke installation setup image

5) Click 'Web Installation' to start the installation. Here is the example of PHP-Nuke installation page:

PHP-Nuke pre-installation check image

6) The first PHP-Nuke installation setup page is the 'Pre-installation check'. Make sure all requirements are in green color. It's stated here: If any of these items are highlighted in red then please take actions to correct them. Failure to do so could lead to your PHP-Nuke installation not functioning correctly.

The example here shows that the 'config.php' file is 'red' because it's unwritable. So we have to give write permission to the file. The 'config.php' file is in the 'html' folder of the extracted PHP-Nuke directory (full path: /var/www/PHP-Nuke-directory/html/config.php). See the steps below on how to give write permission to the file if you are using Ubuntu:

[email protected]:/var/www# cd mufti/html/
[email protected]:/var/www/mufti/html# ls -l
total 164
drwxr-xr-x 6 root root 4096 2010-04-21 11:27 admin
-rw-r--r-- 1 root root 21567 2010-04-21 11:27 admin.php
-rw-r--r-- 1 root root 2521 2010-04-21 11:27 backend.php
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 blocks
-rw-r--r-- 1 root root 5282 2010-04-21 11:27 config.php
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 db
-rw-r--r-- 1 root root 3041 2010-04-21 11:27 footer.php
-rw-r--r-- 1 root root 2552 2010-04-21 11:27 header.php
drwxr-xr-x 12 root root 4096 2010-04-21 11:27 images
drwxr-xr-x 4 root root 4096 2010-04-21 11:27 includes
-rw-r--r-- 1 root root 3556 2010-04-21 11:27 index.php
drwxr-xr-x 4 root root 4096 2010-04-21 11:27 install
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 language
-rw-r--r-- 1 root root 59839 2010-04-21 11:27 mainfile.php
drwxr-xr-x 25 root root 4096 2010-04-21 11:27 modules
-rw-r--r-- 1 root root 5429 2010-04-21 11:27 modules.php
-rw-r--r-- 1 root root 264 2010-04-21 11:27 robots.txt
drwxr-xr-x 16 root root 4096 2010-04-21 11:27 themes
-rw-r--r-- 1 root root 57 2010-04-21 11:27 ultramode.txt

Use Linux chmod command to change permission:

[email protected]:/var/www/mufti/html# chmod 666 config.php
[email protected]:/var/www/mufti/html# ls -l
total 164
drwxr-xr-x 6 root root 4096 2010-04-21 11:27 admin
-rw-r--r-- 1 root root 21567 2010-04-21 11:27 admin.php
-rw-r--r-- 1 root root 2521 2010-04-21 11:27 backend.php
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 blocks
-rw-rw-rw- 1 root root 5282 2010-04-21 11:27 config.php
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 db
-rw-r--r-- 1 root root 3041 2010-04-21 11:27 footer.php
-rw-r--r-- 1 root root 2552 2010-04-21 11:27 header.php
drwxr-xr-x 12 root root 4096 2010-04-21 11:27 images
drwxr-xr-x 4 root root 4096 2010-04-21 11:27 includes
-rw-r--r-- 1 root root 3556 2010-04-21 11:27 index.php
drwxr-xr-x 4 root root 4096 2010-04-21 11:27 install
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 language
-rw-r--r-- 1 root root 59839 2010-04-21 11:27 mainfile.php
drwxr-xr-x 25 root root 4096 2010-04-21 11:27 modules
-rw-r--r-- 1 root root 5429 2010-04-21 11:27 modules.php
-rw-r--r-- 1 root root 264 2010-04-21 11:27 robots.txt
drwxr-xr-x 16 root root 4096 2010-04-21 11:27 themes
-rw-r--r-- 1 root root 57 2010-04-21 11:27 ultramode.txt

7) Click 'Check again' after you are done and see if you got all green result as in the example below:

Successful PHP-Nuke pre-installation check image

8) Let's scroll down to the 'Recommended' section. We don't have to get all green here as it's stated: These settings are recommended for PHP in order to ensure full compatibility with PHP-Nuke. However, PHP-Nuke will still operate if your settings do not quite match the recommended.

Recommended PHP-Nuke pre-installation check image

9) The final section shows other files that need to be writable. Give write permission to the 'ultramode.txt' since it's red.

[email protected]:/var/www/mufti/html# chmod 666 ultramode.txt
[email protected]:/var/www/mufti/html# ls -l
total 164
drwxr-xr-x 6 root root 4096 2010-04-21 11:27 admin
-rw-r--r-- 1 root root 21567 2010-04-21 11:27 admin.php
-rw-r--r-- 1 root root 2521 2010-04-21 11:27 backend.php
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 blocks
-rw-rw-rw- 1 root root 5282 2010-04-21 11:27 config.php
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 db
-rw-r--r-- 1 root root 3041 2010-04-21 11:27 footer.php
-rw-r--r-- 1 root root 2552 2010-04-21 11:27 header.php
drwxr-xr-x 12 root root 4096 2010-04-21 11:27 images
drwxr-xr-x 4 root root 4096 2010-04-21 11:27 includes
-rw-r--r-- 1 root root 3556 2010-04-21 11:27 index.php
drwxr-xr-x 4 root root 4096 2010-04-21 11:27 install
drwxr-xr-x 2 root root 4096 2010-04-21 11:27 language
-rw-r--r-- 1 root root 59839 2010-04-21 11:27 mainfile.php
drwxr-xr-x 25 root root 4096 2010-04-21 11:27 modules
-rw-r--r-- 1 root root 5429 2010-04-21 11:27 modules.php
-rw-r--r-- 1 root root 264 2010-04-21 11:27 robots.txt
drwxr-xr-x 16 root root 4096 2010-04-21 11:27 themes
-rw-rw-rw- 1 root root 57 2010-04-21 11:27 ultramode.txt
[email protected]:/var/www/mufti/html#

Press 'Check again' to see the changes.If you have all green, click next to proceed with the PHP-Nuke installation.

All green PHP-Nuke pre-installation check image

10) Here is the PHP-Nuke 'License' for you to read before you continue the installation. Click Next if want to continue.

PHP-Nuke License image

11) Mysql configuration:

PHP-Nuke installation setup mysql configuration check image

PHP-Nuke warns you that if a database with the same name exist, it will be deleted. Make sure you key in the correct database name. Click OK to continue.

PHP-Nuke installation setup mysql configuration check confirmation image

12) Now you need to provide a name for your website. PHP-Nuke will use this name all over your site. Click Next when you are done. See the example below:

PHP-Nuke installation setup enter website name image

13) In this step PHP-Nuke is going to create the super user administrator account for your website. There are site url and password automatically generated for you. You can change the password and provide the administrator email address. Remember the administrator account is 'admin'. You can change the account name later in the admin panel. Click Next when you are done.

PHP-Nuke installation setup super user administrator creation image

14) This is the final step in PHP-Nuke installation setup. Write down the administrator username and password. The last thing you should do now is to delete the 'install' directory in the web server (rm -r /var/www/php-nuke-directory/html/install). When you are done, click Administration to go to the admin panel. You can login to your new website using the administrator username and password given above.

PHP-Nuke installation setup successful image

You can login to your new website using the administrator username and password given above.

PHP-Nuke installation setup administration system login image

That's all.

Tags: 

Add new comment

Filtered HTML

  • Web page addresses and e-mail addresses turn into links automatically.
  • Allowed HTML tags: <a> <em> <strong> <cite> <blockquote> <code> <ul> <ol> <li> <dl> <dt> <dd>
  • Lines and paragraphs break automatically.

Plain text

  • No HTML tags allowed.
  • Web page addresses and e-mail addresses turn into links automatically.
  • Lines and paragraphs break automatically.
By submitting this form, you accept the Mollom privacy policy.