Installing Xoops

From The Uniform Server Wiki
Jump to navigation Jump to search

MPG UniCenter

How to install Xoops on Uniform Server 3.5-Apollo

Xoops is easy to install on Uniform Server 3.5-Apollo.

This step-by-step guide shows how to install Xoops and resolve a portability issue.


Install Uniform server

  1. A) Create a new folder named xoops_uniform_server
  2. Extract a new copy of Uniform Server to this folder
  3. Run Uniform Server. From apanel select PHP configuration (left menu)
  4. Set Register Globals: Off click Save
  5. Restart Uniform Server.

Download Xoops

  1. B) Create a new folder xoops_temp (Can be any name its only a tempory folder)
  2. Download the latest version ( of Xoops from
  3. Copy the file dowloaded ( to xoops_temp
  4. Unzip into this folder.

Copy files to UniformServer

  1. C) Expand the folder xoops-2.3.1
  2. D) Copy folder htdocs to Uniform's root folder www
  3. E) Rename the copied folder htdocs to xoops (can be any name)
  4. E1) Expand this folder (xoops)
  5. F) Move (do not copy) the two folders:
    xoops_data and xoops_lib to Uniforms's home folder
  6. While in folder xoops remove the read only attribute for the following folders:
    (right click properties uncheck read only box click apply)
  • G1) uploads/
  • G2) cache/
  • G3) templates_c/

Still in folder xoops locate file mainfile.php and mainfile.dist.php check they are writeable if not remove read only atribute.

  1. H) Expand folder "home" remove the read-only attribute
    for the following folder and all its sub-folders:
  • xoops_data/
  • xoops_data/configs/
  • xoops_data/caches/
  • xoops_data/caches/xoops_cache/
  • xoops_data/caches/smarty_cache/
  • xoops_data/caches/smarty_compile/

Uc xoops install.gif


Install Xoops

  1. If not already running start Uniform Server. Xoops installation is mostly a click through exercise.
  2. Type the following into a browser: http://localhost/xoops/
  3. Choose your language: Click Next
  4. Welcome to the XOOPS installation assistant: Click Next
  5. Checking your server configuration: Click Next
  6. Paths settings: This will fail on xoops_data and xoops_lib these were moved for security.
  • Change the path from: W:/www/xoops/xoops_data to W:\home\xoops_data
    (Note when you click in the next text box the above path will be found)
  • Change path from: W:/www/xoops/xoops_lib to W:\home\xoops_lib
    (Click in one of the other text boxes the path will be found)
  • Click Next
  1. Database connection: Enter root for user name and root for password click Next
  2. Database configuration: For database name enter xoops click Next
  3. Saving your system configuration: Click Next
  4. Database tables creation: Click Next
  5. Please enter your initial settings:
    Admin login: admin
    Admin e-mail: -- use a real e-mail address
    Admin password: admin -- use a real password
    Click Next
  6. Saving your settings to the database: Click Next
  7. Welcome to your XOOPS site:
    "You can now access the home page of your site." -- don't click the link.
    Click Next
  8. Login as admin

Note: These warnings:

WARNING: Directory W:/www/xoops/install/ exists on your server.
Please remove this directory for security reasons.
WARNING: File W:/www/xoops/mainfile.php is writeable by the server.
Please change the permission of this file for security reasons.
in Unix (444), in Win32 (read-only)

Make above changes and refresh the page warning no longer displayed.


You can access your site by typing the following into a browser: http://localhost/xoops/index.php



A few paths are hard coded if after installation you wish to use a different drive letter make the following modifications to Xoops.

Edit file mainfile.php found in the xoops folder (you will need to remove read only attribute)

The variable $_ENV['Disk'] picks up the current virtual drive letter.

Replace every occurrence of drive letter “W” with the variable $_ENV['Disk'] as show in the lines outdented.

    // XOOPS Physical Paths
    // Physical path to the XOOPS documents (served) directory WITHOUT trailing slash
//define( 'XOOPS_ROOT_PATH', 'W:/www/xoops' );
define( 'XOOPS_ROOT_PATH', $_ENV['Disk'].':/www/xoops' );

    // For forward compatibility
    // Physical path to the XOOPS library directory WITHOUT trailing slash
//define( 'XOOPS_PATH', 'W:/home/xoops_lib' );
define( 'XOOPS_PATH', $_ENV['Disk'].':/home/xoops_lib' );
    // Physical path to the XOOPS datafiles (writable) directory WITHOUT trailing slash
//define( 'XOOPS_VAR_PATH', 'W:/home/xoops_data' );
define( 'XOOPS_VAR_PATH', $_ENV['Disk'].':/home/xoops_data' );
    // Alias of XOOPS_PATH, for compatibility, temporary solution

Note: After saving the file set it’s file attribute back to read only.



From the above you have seen how easy it is to install Xoops.

If you only want to explore the package take a look at Mini Server 21 - Xoops 2.3.1 it's a pre-installed ready to go package.


Uc small logo.gif Ric