> For the complete documentation index, see [llms.txt](https://xoops.gitbook.io/xoops-installation-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xoops.gitbook.io/xoops-installation-guide/readme.md).

# Introduction

![logoXoops.jpg](/files/-LD6N0LerWeJsroJguFX)

## XOOPS Installation Guide

#### for XOOPS 2.7.0

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

Download the current release from [XoopsCore27 Releases on GitHub](https://github.com/XOOPS/XoopsCore27/releases).

### How to Contribute

[You can contribute on GitHub](https://github.com/XoopsDocs/xoops-installation-guide). Changes will be [pushed to Gitbook.io automatically](https://www.gitbook.com/book/xoops/xoops-installation-guide/activity) when the [main repository](https://github.com/XoopsDocs/xoops-installation-guide) 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](https://github.com/GitbookIO/editor/blob/master/README.md). The desktop app will give you a live preview option.

## Table of Content

* [Chapter 1: Preamble](/xoops-installation-guide/chapter-1-preamble.md)
* [Chapter 2: Introduction](/xoops-installation-guide/chapter-2-introduction.md)
* [Chapter 3: Server Configuration Check](/xoops-installation-guide/chapter-3-server-configuration-check.md)
* [Chapter 4: Take the Right Path!](/xoops-installation-guide/chapter-4-take-the-right-path.md)
* [Chapter 5: Database Connections](/xoops-installation-guide/chapter-5-database-connections.md)
* [Chapter 6: Final System Configuration](/xoops-installation-guide/chapter-6-final-system-configuration.md)
* [Chapter 7: Administration Settings](/xoops-installation-guide/chapter-7-administration-settings.md)
* [Chapter 8: Ready to go!](/xoops-installation-guide/chapter-8-ready-to-go.md)
* [Chapter 9: Upgrade Existing XOOPS Installation](/xoops-installation-guide/chapter-9-upgrade-existing-xoops-installation.md)

### Appendixes

* [Appendix 1: Working with the XOOPS Admin GUI](/xoops-installation-guide/appendixes/appendix-1-working-with-the-new-admin-gui-our-dashboard.md)
* [Appendix 2: Uploading XOOPS via FTP](/xoops-installation-guide/appendixes/appendix-2-uploading-xoops-via-ftp.md)
* [Appendix 3: Translating XOOPS to Local Language](/xoops-installation-guide/appendixes/appendix-3-translating-xoops-to-local-language.md)
* [Appendix 4: Useful Tools](/xoops-installation-guide/appendixes/appendix-4-useful-tools.md)
* [Appendix 5: Increase security of your XOOPS installation](/xoops-installation-guide/appendixes/appendix-5-increase-security-of-your-xoops-installation.md)

### 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](/xoops-installation-guide/chapter-9-upgrade-existing-xoops-installation.md).

* [Upgrading from XOOPS 2.4.5 (easy way)](/xoops-installation-guide/historical-upgrade-notes/upgrading-from-xoops-2.4.5-easy-way.md)
* [Upgrading from XOOPS 2.0.x (above 2.0.14) and 2.2.x](/xoops-installation-guide/historical-upgrade-notes/upgrading-from-xoops-2.0.-above-2.0.14-and-2.2..md)
* [Upgrading from any XOOPS (2.0.7 to 2.0.13.2)](/xoops-installation-guide/historical-upgrade-notes/upgrading-from-any-xoops-2.0.7-to-2.0.13.2.md)
* [Upgrading a non UTF-8 site](/xoops-installation-guide/historical-upgrade-notes/upgrading-a-non-utf-8-site.md)
* [Upgrading XoopsEditor package](/xoops-installation-guide/historical-upgrade-notes/upgrading-xoopseditor-package.md)

### License

[![Creative Commons License](https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png)](http://creativecommons.org/licenses/by-nc-sa/4.0/) Unless specified, this content is licensed under a [Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License](http://creativecommons.org/licenses/by-nc-sa/4.0/).

All derivative works are to be attributed to XOOPS Project ([www.xoops.org](https://xoops.org)).
