Introduction

XOOPS Installation Guide

for XOOPS 2.7.0

© 2026 XOOPS Project (https://xoops.org)

Download the current release from XoopsCore27 Releases on GitHub.

How to Contribute

You can contribute on GitHub. Changes will be pushed to Gitbook.io automatically when the main repository changes.

Editing the book can be done either by updating the markdown files with a text editor, or opening the repository in the Gitbook desktop app. The desktop app will give you a live preview option.

Table of Content

• Chapter 1: Preamble
• Chapter 2: Introduction
• Chapter 3: Server Configuration Check
• Chapter 4: Take the Right Path!
• Chapter 5: Database Connections
• Chapter 6: Final System Configuration
• Chapter 7: Administration Settings
• Chapter 8: Ready to go!
• Chapter 9: Upgrade Existing XOOPS Installation

Appendixes

• Appendix 1: Working with the XOOPS Admin GUI
• Appendix 2: Uploading XOOPS via FTP
• Appendix 3: Translating XOOPS to Local Language
• Appendix 4: Useful Tools
• Appendix 5: Increase security of your XOOPS installation

Historical Upgrade Notes

The pages below describe legacy upgrade paths that pre-date XOOPS 2.7.0. For any upgrade to 2.7.0, follow Chapter 9.

• Upgrading from XOOPS 2.4.5 (easy way)
• Upgrading from XOOPS 2.0.x (above 2.0.14) and 2.2.x
• Upgrading from any XOOPS (2.0.7 to 2.0.13.2)
• Upgrading a non UTF-8 site
• Upgrading XoopsEditor package

License

Unless specified, this content is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

All derivative works are to be attributed to XOOPS Project (www.xoops.org).