1. Getting Started
      1. Basic Installation
      2. What is MODx
    2. Content Editing
      1. Editing Documents
      2. MODx Tags
        1. Document Variables
      3. Terminology
      4. The Manager
      5. Who Should Read This
    3. Designing
      1. Adding Chunks
      2. Adding MODx Tags
        1. Resource Fields
      3. Adding Snippets
      4. Document Caching
      5. Template Basics
    4. Administration
      1. Friendly URL Solutions
      2. Manager Users
        1. Manager Roles And Groups
        2. Reset your Password - Unblock your User
        3. Why Manager Users, Roles and Groups
      3. Moving Site
      4. Taking sites down for maintenance
      5. Upgrading
      6. Web Users
        1. Creating a Web User
        2. Web User Groups and Document Groups
        3. Why Web Users and Groups
    5. Developer's Guide
      1. API Reference
        1. DBAPI
          1. delete
          2. escape
          3. getInsertId
          4. query
          5. select
          6. update
        2. Document Object
        3. DocumentParser Object
          1. addEventListener
          2. changeWebUserPassword
          3. documentContent
          4. documentGenerated
          5. documentIdentifier
          6. documentListing
          7. documentMethod
          8. documentObject
          9. getAllChildren
          10. getCachePath
          11. getChildIds
          12. getDocumentChildren
          13. getDocumentChildrenTVarOutput
          14. getDocumentChildrenTVars
          15. getLoginUserID
          16. getLoginUserName
          17. getLoginUserType
          18. getManagerPath
          19. getParent
          20. getParentIds
          21. getUserData
          22. hasPermission
          23. isBackend
          24. isFrontend
          25. logEvent
          26. maxParserPasses
          27. minParserPasses
          28. regClientCSS
          29. runSnippet
          30. table_prefix
          31. tstart
          32. webAlert
      2. Chunks
      3. Modules
        1. How to create and run a module from within the Content Manager
        2. Managing module dependencies
        3. Setting up configuration parameters
        4. Writing the module code
      4. Plugins
      5. Snippets
      6. Template Variables
        1. (at) Binding
          1. (at)CHUNK
          2. (at)DIRECTORY
          3. (at)DOCUMENT
          4. (at)EVAL
          5. (at)FILE
          6. (at)INHERIT
          7. (at)SELECT
          8. What are (at) Bindings
        2. Creating a Template Variable
        3. What are Template Variables
        4. Widgets
          1. Misc. Widget
          2. DataGrid Widget
          3. Floater Widget
          4. Hyperlink Widget
          5. Marquee Widget
          6. RichTextBox Widget
          7. Ticker Widget
          8. Viewport Widget
          9. What are Widgets

Basic Installation

Last edited by Emmanuel Piguet on Jun 10, 2014.
  1. Download the latest version of MODX Evolution and unzip the MODX zip file (e.g. modx-1.0.14.zip) to a folder on your hard drive (e.g. c:\temp)
  2. Copy or FTP the unzipped files and folders inside the new modx-1.0.14 directory into the root of your website (e.g. c:\mymodxsite\ or ftp.mymodxsite.com).
  3. After you've put the unzipped files and folders into the root of your website directory, open your web browser and run the index.php file located inside the install folder on your MODX website. For example, http://yoursite/install/index.php, where "yoursite" is the name of your website.
  4. Follow the simple on-screen instructions to complete the installation.
    Notes
    Database Note: MODX Evolution uses a MySQL database. You will need the username and password to your database to install MODX. If your database user does not have database creation permissions on the server, you will also need to have a database already created for MODX to use.

    Note to *nix users: When you have put the unzipped files and folders in your website, make sure that the /assets/cache (and its files), /assets/export and /assets/images folders are writeable by the web server (777 if PHP is running as an Apache module, or 755 if PHP running as a CGI with "suexec" enabled). You also may need to create an empty file in the manager/includes directory named config.inc.php and make it writable. After the installation is completed, change the permissions on that file to read-only.

    Upgrade Note: When upgrading an existing MODX installation, select the upgrade menu option on the page immediately following the License Agreement page. Before upgrading, save all your unique or customized files, such as images, CSS files and custom snippets, and back up your database. Make sure that you upload all the files and folders from the new version; a common cause of problems with upgrading is forgetting to upload the new index.php files from the site root and/or the /manager folder.

When installing, you will come to a page that gives you options for installing various plugins and snippets. The first option will install a complete sample site, with several documents and a complex menu structure. It also has a few optional features, such as front-end blog-style document creation. If you are new to MODX and want to learn how it works, installing this sample site is an excellent way to begin.

Suggest an edit to this page on GitHub (Requires GitHub account. Opens a new window/tab).