Skip to content
fireproofsocks edited this page Nov 4, 2014 · 5 revisions

Installation

Screencast: Installing Repoman

Query Overview

Via MODX Package Manager

This is the usual thing: download the package from the MODX site and install it. However, the recommendation here is to install this via the command line.

Via the Command Line

You can install Repoman via the standard MODx package manager, or you can install Repoman via Repoman (yes, some dog-fooding is possible here).

  1. Clone the Repoman repository from https://github.com/craftsmancoding/repoman to a dedicated directory inside your MODX web root, e.g. "mypackages"

    cd your/modx/public_dir mkdir repos cd repos git clone git@github.com:craftsmancoding/repoman.git

  2. Run "composer install" on your new repository to pull in the package dependencies.

    cd repoman composer install

  3. Run the command-line repoman tool on the repoman/ directory, e.g.

    php repoman install .

Troubleshooting

On MAMP environments, you must link "php" to the MAMP version of PHP, not to the native Mac version.
Due to permissions issues, you may also need to run the commands as an admin user using "sudo", e.g.

su - admin
cd /path/to/modx/repos/repoman
sudo composer install
sudo php repoman install .

For this reason, it is recommended that you use Vagrant or some other emulated environment to avoid these headaches, e.g. http://laravel.com/docs/4.2/homestead

Clone this wiki locally