# Installation

**URL:** https://community.modx.com/c/getting-started/installation/8.md

[Latest](https://community.modx.com/latest.md) · [Categories](https://community.modx.com/categories.md) · [Tags](https://community.modx.com/tags.md)

---

## [About the Installation category](https://community.modx.com/t/about-the-installation-category/19)

<div class="topic-metadata">

**Author:** [@rthrash](https://community.modx.com/u/rthrash)\
**Replies:** 0

</div>

Get MODX running for the first time on your server, and anything else you need for installation.

---

## [Installation error](https://community.modx.com/t/installation-error/8641)

<div class="topic-metadata">

**Author:** [@Abdrf](https://community.modx.com/u/Abdrf)\
**Replies:** 4\
**Last updated:** [June 26, 2025, 1:21pm UTC](https://community.modx.com/t/installation-error/8641 "2025-06-26T13:21:21Z")

</div>

Warning: Attempt to read property “config” on null in C:\\wamp64\\www\\modx\\core\\vendor\\xpdo\\xpdo\\src\\xPDO\\xPDO.php on line 304

---

## [Copying Modx Site using backup\\restore?](https://community.modx.com/t/copying-modx-site-using-backup-restore/8405)

<div class="topic-metadata">

**Author:** [@david000](https://community.modx.com/u/david000)\
**Replies:** 5\
**Last updated:** [March 12, 2025, 7:37pm UTC](https://community.modx.com/t/copying-modx-site-using-backup-restore/8405 "2025-03-12T19:37:41Z")

</div>

Hi there, I’m a long time if non skilled user of Modx and wish to copy an existing site into the dev subdomain of the existing site. The idea is that I can then evolve and make some substantial changes to the site in s…

---

## [Invalid default value for 'occurred'](https://community.modx.com/t/invalid-default-value-for-occurred/8387)

<div class="topic-metadata">

**Author:** [@chrisandy](https://community.modx.com/u/chrisandy)\
**Replies:** 7\
**Last updated:** [March 4, 2025, 3:53pm UTC](https://community.modx.com/t/invalid-default-value-for-occurred/8387 "2025-03-04T15:53:28Z")

</div>

On upgrading from MODX 2.8.3 to MODX 2.8.8 (using the upGradeModx extra)… Error updating table for class modManagerLog Array ( \[0\] =\> 42000 \[1\] =\> 1067 \[2\] =\> Invalid default value for 'occurred' ) …a couple of weeks a…

---

## [Fatal error: Uncaught TypeError: fwrite(): Argument #1 ($stream) must be of type resource, bool given](https://community.modx.com/t/fatal-error-uncaught-typeerror-fwrite-argument-1-stream-must-be-of-type-resource-bool-given/7888)

<div class="topic-metadata">

**Author:** [@photomike](https://community.modx.com/u/photomike)\
**Replies:** 20\
**Last updated:** [December 12, 2024, 9:10pm UTC](https://community.modx.com/t/fatal-error-uncaught-typeerror-fwrite-argument-1-stream-must-be-of-type-resource-bool-given/7888 "2024-12-12T21:10:59Z")

</div>

Installing on remote VM, Alma Linux 5.14.0-427.22.1.el9\_4.x86\_64 (from uname -a) PHP 8.2.21 (cli) mariadb Ver 15.1 Distrib 10.5.22-MariaDB, for Linux (x86\_64) using EditLine wrapper Apache2 (httpd) version not show…

---

## [Can connect to MySQL but not create DB, 1st MODX 3 installation](https://community.modx.com/t/can-connect-to-mysql-but-not-create-db-1st-modx-3-installation/6634)

<div class="topic-metadata">

**Author:** [@zaphodx](https://community.modx.com/u/zaphodx)\
**Replies:** 21\
**Last updated:** [October 24, 2024, 11:52am UTC](https://community.modx.com/t/can-connect-to-mysql-but-not-create-db-1st-modx-3-installation/6634 "2024-10-24T11:52:59Z")

</div>

Have successfully installed MODX 2.x over 50 times, but having an issue with my first 3.x installation. As usual, I created a database first in cPanel, then run the “Setup” page I can connect to MySQL (I had to manuall…

---

## [Moving site to new server](https://community.modx.com/t/moving-site-to-new-server/2197)

<div class="topic-metadata">

**Author:** [@rickardbe](https://community.modx.com/u/rickardbe)\
**Replies:** 6\
**Last updated:** [October 16, 2024, 2:10pm UTC](https://community.modx.com/t/moving-site-to-new-server/2197 "2024-10-16T14:10:16Z")

</div>

Hi ! I have tried to move my site to a new server with out any luck. I have read the two docs below. Does not help me since it is to complex. https://docs.modx.com/current/en/getting-started/maintenance/moving-your-si…

---

## [How Do I Migrate/Copy a MODx Site for Use as a New Site?](https://community.modx.com/t/how-do-i-migrate-copy-a-modx-site-for-use-as-a-new-site/7779)

<div class="topic-metadata">

**Author:** [@mmcgee](https://community.modx.com/u/mmcgee)\
**Replies:** 7\
**Last updated:** [September 26, 2024, 7:25am UTC](https://community.modx.com/t/how-do-i-migrate-copy-a-modx-site-for-use-as-a-new-site/7779 "2024-09-26T07:25:48Z")

</div>

Hoping to obtain tips for migrating a MODx site for me to use as a new website so that I don’t have to start completely from scratch. I updated MODX version of the old site, installed the new MODx site for my new project…

---

## [Dropzone Limits](https://community.modx.com/t/dropzone-limits/7548)

<div class="topic-metadata">

**Author:** [@goomba](https://community.modx.com/u/goomba)\
**Replies:** 1\
**Last updated:** [September 4, 2024, 11:34am UTC](https://community.modx.com/t/dropzone-limits/7548 "2024-09-04T11:34:13Z")

</div>

Hopefully this is in the correct area. Thanks to a lot of post here, we’re making good progress with Fred. Still finding fluid docs on how to use Fred, but trial and error are a good learning process. At some point in …

---

## [ERROR in Installation](https://community.modx.com/t/error-in-installation/7831)

<div class="topic-metadata">

**Author:** [@JstTan](https://community.modx.com/u/JstTan)\
**Replies:** 6\
**Last updated:** [July 26, 2024, 2:08am UTC](https://community.modx.com/t/error-in-installation/7831 "2024-07-26T02:08:14Z")

</div>

Hi everyone! I am currently trying to set up MODX on a Linux KVM VPS. However, I keep facing this issue below.

---

## [Upgrade 2.8.7 to 3.0.5: Uncaught Error: Interface "modMediaSourceInterface" not found](https://community.modx.com/t/upgrade-2-8-7-to-3-0-5-uncaught-error-interface-modmediasourceinterface-not-found/7827)

<div class="topic-metadata">

**Author:** [@frischnetz](https://community.modx.com/u/frischnetz)\
**Replies:** 2\
**Last updated:** [June 17, 2024, 4:24pm UTC](https://community.modx.com/t/upgrade-2-8-7-to-3-0-5-uncaught-error-interface-modmediasourceinterface-not-found/7827 "2024-06-17T16:24:47Z")

</div>

Hi! I’m trying to upgrade a 12 year old modx-site to 3.0.5. It was always updated to the latest MODX-version and all the packages were kept recent, too. So I purged all packages that are known to be troublesome and rem…

---

## [MODX 3 dependencies on upgrade](https://community.modx.com/t/modx-3-dependencies-on-upgrade/5591)

<div class="topic-metadata">

**Author:** [@cottagestuff](https://community.modx.com/u/cottagestuff)\
**Replies:** 11\
**Last updated:** [April 22, 2024, 2:36pm UTC](https://community.modx.com/t/modx-3-dependencies-on-upgrade/5591 "2024-04-22T14:36:59Z")

</div>

I had a site running MODX 2.8.4 nicely on PHP 7.4. Now trying to upgrade to 3.0.1. Running setup immediately gives this error message: Site temporarily unavailable; missing dependencies. Is there an exhaustive list some…

---

## [Error : Make sure your PHP session configuration is valid and working](https://community.modx.com/t/error-make-sure-your-php-session-configuration-is-valid-and-working/4016)

<div class="topic-metadata">

**Author:** [@spheerys](https://community.modx.com/u/spheerys)\
**Replies:** 9\
**Last updated:** [December 29, 2023, 8:53pm UTC](https://community.modx.com/t/error-make-sure-your-php-session-configuration-is-valid-and-working/4016 "2023-12-29T20:53:02Z")

</div>

Hi, I have the error when I try a fresh install of MODX 2.8.2 : FATAL ERROR: MODX Setup cannot continue. Make sure your PHP session configuration is valid and working. My apache error log is empty. My server is run…

---

## [Modx transport providers empty](https://community.modx.com/t/modx-transport-providers-empty/6697)

<div class="topic-metadata">

**Author:** [@wemyssweb](https://community.modx.com/u/wemyssweb)\
**Replies:** 2\
**Last updated:** [May 11, 2023, 12:53pm UTC](https://community.modx.com/t/modx-transport-providers-empty/6697 "2023-05-11T12:53:23Z")

</div>

Updated Xampp, exported database and moved folders in hdocs(modx folder). moved folders back and imported database. Everything else seems to work, but I am missing transport providers. They are also missing from the d…

---

## [Error 503: Service Temporarily unavailable after downloading and attempting to install sdk package](https://community.modx.com/t/error-503-service-temporarily-unavailable-after-downloading-and-attempting-to-install-sdk-package/6412)

<div class="topic-metadata">

**Author:** [@WestonSimon](https://community.modx.com/u/WestonSimon)\
**Replies:** 1\
**Last updated:** [March 24, 2023, 2:16pm UTC](https://community.modx.com/t/error-503-service-temporarily-unavailable-after-downloading-and-attempting-to-install-sdk-package/6412 "2023-03-24T14:16:47Z")

</div>

I am using xampp with php version 8.2 to host modx. It lets me get all the way to the test screen but when I press next the service unavailable screen comes up. php.ini memory limit 512M Max execution time 120s

---

## [Moving the core folder outside webroot](https://community.modx.com/t/moving-the-core-folder-outside-webroot/6181)

<div class="topic-metadata">

**Author:** [@spheerys](https://community.modx.com/u/spheerys)\
**Replies:** 1\
**Last updated:** [December 20, 2022, 12:08am UTC](https://community.modx.com/t/moving-the-core-folder-outside-webroot/6181 "2022-12-20T00:08:21Z")

</div>

Inside the official MODX docs I have found Core folder - Upgrading from 2.x to 3.0 | MODX Documentation But on several MODX 3.0.2 installations, I moved the core folder outside the webroot without problem. Is the doc n…

---

## [Mailgun and Modx](https://community.modx.com/t/mailgun-and-modx/5524)

<div class="topic-metadata">

**Author:** [@carlo\_13](https://community.modx.com/u/carlo_13)\
**Replies:** 3\
**Last updated:** [June 30, 2022, 10:19pm UTC](https://community.modx.com/t/mailgun-and-modx/5524 "2022-06-30T22:19:08Z")

</div>

Has anyone managed to configure Mailgun for Modx ? If so, would you be so kind to share you settings please ? I have this fresh install of Modx 3 ( php8 and mariadatabase ). Something wrong but I can’t put my finger on …

---

## [Package Manager (V)](https://community.modx.com/t/package-manager-v/5518)

<div class="topic-metadata">

**Author:** [@goomba](https://community.modx.com/u/goomba)\
**Replies:** 2\
**Last updated:** [June 30, 2022, 9:21pm UTC](https://community.modx.com/t/package-manager-v/5518 "2022-06-30T21:21:40Z")

</div>

I am trying to install Fred on a brand new empty Modx V3.0.1-pl site. When I click on “Download Extras” I get the following message: MODX received a blank response from the provider. Please double check your service URL…

---

## [Upgrading (advance) from 2.6.5-pl to the 2.8.4](https://community.modx.com/t/upgrading-advance-from-2-6-5-pl-to-the-2-8-4/5379)

<div class="topic-metadata">

**Author:** [@akommar](https://community.modx.com/u/akommar)\
**Replies:** 3\
**Last updated:** [June 3, 2022, 11:04pm UTC](https://community.modx.com/t/upgrading-advance-from-2-6-5-pl-to-the-2-8-4/5379 "2022-06-03T23:04:23Z")

</div>

Hello, I decided to upgrade from 2.6.5-pl to the 2.8.4. I remember that I moved the standard manager location so as I understand I need to use advanced installation package. Do I get it correctly I need to unzip the pac…

---

## [Upgrade to modx 3.0.1 from 2.8.4 media sources disapear](https://community.modx.com/t/upgrade-to-modx-3-0-1-from-2-8-4-media-sources-disapear/5318)

<div class="topic-metadata">

**Author:** [@servingpixels](https://community.modx.com/u/servingpixels)\
**Replies:** 3\
**Last updated:** [May 6, 2022, 12:13pm UTC](https://community.modx.com/t/upgrade-to-modx-3-0-1-from-2-8-4-media-sources-disapear/5318 "2022-05-06T12:13:48Z")

</div>

upgraded to modx 3 now media sources (I usually always have 2 for all my websites). can not be accessed. I am not sure why it give me a 500 error I can also not add a new one. however in the resources I can access the…

---

## [Remove footer links](https://community.modx.com/t/remove-footer-links/5098)

<div class="topic-metadata">

**Author:** [@mytwebsolutions](https://community.modx.com/u/mytwebsolutions)\
**Replies:** 4\
**Last updated:** [March 26, 2022, 9:13am UTC](https://community.modx.com/t/remove-footer-links/5098 "2022-03-26T09:13:48Z")

</div>

Iam new at modx. Iam trying to do learn. One of my cusomer using modx and he need some changes. First one is remove some footer links Enable lightbox for gallery page. Now when i click on the image nothing showing …

---

## [Migrating v2.6.4, Website doesn't load, in Manager only the Landingpage shows](https://community.modx.com/t/migrating-v2-6-4-website-doesnt-load-in-manager-only-the-landingpage-shows/4706)

<div class="topic-metadata">

**Author:** [@JonAss69](https://community.modx.com/u/JonAss69)\
**Replies:** 9\
**Last updated:** [December 13, 2021, 1:35pm UTC](https://community.modx.com/t/migrating-v2-6-4-website-doesnt-load-in-manager-only-the-landingpage-shows/4706 "2021-12-13T13:35:24Z")

</div>

I tried to migrate a website, the file structure on the old server was changed, I just took assets and core/packages and /components, put it in after a fresh install on the new server and imported the database without mo…

---

## [Don't understand verbiage on 3.0.0-beta1 (rel. 9-Nov-2021) release announcement](https://community.modx.com/t/dont-understand-verbiage-on-3-0-0-beta1-rel-9-nov-2021-release-announcement/4628)

<div class="topic-metadata">

**Author:** [@stormhike](https://community.modx.com/u/stormhike)\
**Replies:** 15\
**Last updated:** [November 30, 2021, 10:28pm UTC](https://community.modx.com/t/dont-understand-verbiage-on-3-0-0-beta1-rel-9-nov-2021-release-announcement/4628 "2021-11-30T22:28:39Z")

</div>

I’m confused over whether I can install 3.0.0-beta 1 or not, maybe I am being dumb . I have moved my core so I usually do an advanced install. The announcement text is: \* To install this software, extract the files to y…

---

## [Unable to install using a non-standard port](https://community.modx.com/t/unable-to-install-using-a-non-standard-port/4141)

<div class="topic-metadata">

**Author:** [@DavidWakelin](https://community.modx.com/u/DavidWakelin)\
**Replies:** 5\
**Last updated:** [June 9, 2021, 8:51am UTC](https://community.modx.com/t/unable-to-install-using-a-non-standard-port/4141 "2021-06-09T08:51:25Z")

</div>

I am unable to install when using a URL like http://localhost:8080/setup It redirects to http://localhost/setup I presume the core assumes port 80 Any fix for this?

---

## [\[MODX 2.8\] Change setting keys from CLI : possible?](https://community.modx.com/t/modx-2-8-change-setting-keys-from-cli-possible/3802)

<div class="topic-metadata">

**Author:** [@spheerys](https://community.modx.com/u/spheerys)\
**Replies:** 5\
**Last updated:** [March 16, 2021, 7:24pm UTC](https://community.modx.com/t/modx-2-8-change-setting-keys-from-cli-possible/3802 "2021-03-16T19:24:21Z")

</div>

Hi :slight\_smile: Is there a way to change setting keys inside MODX 2.8.1 from CLI ? I’m looking for a way to improve my new MODX installations with my install script.

---

## [Building MODX3 from github](https://community.modx.com/t/building-modx3-from-github/3770)

<div class="topic-metadata">

**Author:** [@sottwell](https://community.modx.com/u/sottwell)\
**Replies:** 0\
**Last updated:** [March 10, 2021, 10:04am UTC](https://community.modx.com/t/building-modx3-from-github/3770 "2021-03-10T10:04:27Z")

</div>

A step-by-step tutorial on installing, building and updating the latest MODX (3.x alpha3 at this time) on the MODX Cloud as a PDF can be downloaded here https://modxcookbook.com/installation/files/build/

---

## [Unneeded files after install \> core/packages/core?](https://community.modx.com/t/unneeded-files-after-install-core-packages-core/3428)

<div class="topic-metadata">

**Author:** [@jaredfhealy](https://community.modx.com/u/jaredfhealy)\
**Replies:** 0\
**Last updated:** [December 23, 2020, 2:59pm UTC](https://community.modx.com/t/unneeded-files-after-install-core-packages-core/3428 "2020-12-23T14:59:51Z")

</div>

Is there any reason that the core/packages/core/ folder could not be removed after MODX is installed? This would be for hosts where the inode count is utilized. It looks like these files are really just used in install, …

---

## [PHP code deprecation notice on installation](https://community.modx.com/t/php-code-deprecation-notice-on-installation/2602)

<div class="topic-metadata">

**Author:** [@geordiechris](https://community.modx.com/u/geordiechris)\
**Replies:** 4\
**Last updated:** [May 4, 2020, 2:58pm UTC](https://community.modx.com/t/php-code-deprecation-notice-on-installation/2602 "2020-05-04T14:58:12Z")

</div>

Hi Folks I am using the latest Modx version (2.7.3) Would anyone have any solutions to not seeing the following notice at the ‘Setup’ screen of the installation process. Deprecated : Array and string offset access syn…

---

## [Manage multiple sites with MODX](https://community.modx.com/t/manage-multiple-sites-with-modx/2366)

<div class="topic-metadata">

**Author:** [@clutchmarketing](https://community.modx.com/u/clutchmarketing)\
**Replies:** 10\
**Last updated:** [March 16, 2020, 6:53pm UTC](https://community.modx.com/t/manage-multiple-sites-with-modx/2366 "2020-03-16T18:53:32Z")

</div>

I am setting up a multi-site MODX installation. Does anyone have a tutorial on how to get multi-sites to work in MODX including if there are any DNS changes that need to be made for the domain(s)?

---

## [Core folder is accessible by web / Move core directory out of the web server's document root](https://community.modx.com/t/core-folder-is-accessible-by-web-move-core-directory-out-of-the-web-servers-document-root/2308)

<div class="topic-metadata">

**Author:** [@gerbenNL](https://community.modx.com/u/gerbenNL)\
**Replies:** 34\
**Last updated:** [March 14, 2020, 8:29am UTC](https://community.modx.com/t/core-folder-is-accessible-by-web-move-core-directory-out-of-the-web-servers-document-root/2308 "2020-03-14T08:29:24Z")

</div>

Trying to find out how to move the /core/ outside of the web server’s document root. I found this explanation on Hardening MODX Revolution - Maintenance | MODX Documentation : Once you move it, you’ll have to update th…

[Next page](https://community.modx.com/c/getting-started/installation/8.md?page=1)
