PHPackages                             instaclick/medusa - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. instaclick/medusa

ActiveLibrary

instaclick/medusa
=================

A small set of command to maintain a mirror of git repositories and create a local satis repository for composer.

0.7(4y ago)131.2k5[2 issues](https://github.com/instaclick/medusa/issues)MITPHP

Since Jun 18Pushed 4y ago6 watchersCompare

[ Source](https://github.com/instaclick/medusa)[ Packagist](https://packagist.org/packages/instaclick/medusa)[ RSS](/packages/instaclick-medusa/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (2)Dependencies (5)Versions (12)Used By (0)

Medusa is a command line tool that works together with Satis to create a local git mirror for your composer projects.

**What the hell???**

What is Medusa, what is it good for?
====================================

[](#what-is-medusa-what-is-it-good-for)

If you have a very slow connection, fetching your project's dependencies through [composer](http://getcomposer.org) can be a pain. My projects were taking more than half a day to update or install on my local machines because of slow networks.

Medusa will create a mirror of all these things on your local machine and let you fetch everything from there rather than fetching the whole source from Github. Each dependency is entirely mirrored, meaning you'll have all versions, tags, and branches on your local machine.

Limitations
===========

[](#limitations)

It will only work with github hosted projects for now.

It has very poor documentation.

It is a very early release, there might be bugs, and the API to use it is definitely confusing.

How to use
==========

[](#how-to-use)

For now, you can do the following:

- Download `medusa.phar` from
- Build the `satis.phar` file from  using `box.phar` from

```
    cd satis
    box.phar compile

```

- Put them both in a folder on your machine
- Inside of that folder, create a `web/` and a `web/repositories/` folder
- Create a `medusa.json` file that looks like this:

```
    {
        // vcs repositories not in packagist
        "repositories": [
            {
                // pseudo package name; used for repo directory structure
                "name": "myvendor/package",
                "url": "git@othervcs:myvendor/package.git"
            }
        ]
        "require": [
            "vendor/package",
            "othervendor/otherpackage",
            //... List all the packages you want here, there dependencies can be
            // auto downloaded as well
        ],
        "repodir": "web/repositories",
        // Optional URL to satis (if not hosted locally)
        "satisurl": "http://user:password@satis.host:port/repositories",
        // Target path for generated satis configuration
        "satisconfig": "satis.json"
    }

```

- Create a satis config file skeleton like this:

```
    {
        "name": "My Repository",
        "homepage": "http://packages.example.org",
        "repositories": [
            // Optionally list repositories not updateable by medusa
        ],
        "require-all": true // if you want to also mirror the dependencies from each package
    }

```

- run `./medusa.phar mirror medusa.json`
- wait a long time

During this time, medusa will first find all the dependencies you need. Then it runs `git clone --mirror` for each of them to create a mirror inside of the specified repodir. Finally, it updates your satis.json file with your new config.

- Run the satis build command: `./satis.phar build satis.json web/`
- Once a day run:

```
    ./medusa.phar update medusa.json
    ./satis.phar build satis.json web/

```

To update all repos and rebuild the satis config.

Other available commands:
=========================

[](#other-available-commands)

`add [--with-deps] package [config-file]`

- `--with-deps` if you want to also mirror the new package's dependencies
- `package` is the package name you want to mirror (eg: symfony/symfony)
- `config-file` is the medusa.json config file; the specified satis.json config file will be updated

Make composer use it
====================

[](#make-composer-use-it)

Point a webserver to the `web/` directory.

In your composer global config file add:

```
    {
        "repositories": [
            {
                "type": "composer",
                "url": "http://my.satis.url"
            }
        ]
    }

```

resolver.json
=============

[](#resolverjson)

The `resolver.json` file is a partial workaround where the package maintainer renames or deletes a package. Where the property name (key) is the original package name, the value is either:

- the new package name (for packages that are renamed), or
- `null` (for packages that have been deleted, i.e., no longer exists in Packagist)

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity24

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 59.2% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~490 days

Recently: every ~732 days

Total

7

Last Release

1682d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/7527f543a29a1e6b1bcbe7525e619a3a02345b49abbc40f775f88a26aaf39a96?d=identicon)[instaclick](/maintainers/instaclick)

---

Top Contributors

[![robocoder](https://avatars.githubusercontent.com/u/922051?v=4)](https://github.com/robocoder "robocoder (42 commits)")[![khepin](https://avatars.githubusercontent.com/u/455656?v=4)](https://github.com/khepin "khepin (12 commits)")[![andygrunwald](https://avatars.githubusercontent.com/u/320064?v=4)](https://github.com/andygrunwald "andygrunwald (9 commits)")[![cordoval](https://avatars.githubusercontent.com/u/328359?v=4)](https://github.com/cordoval "cordoval (3 commits)")[![guilhermeblanco](https://avatars.githubusercontent.com/u/208883?v=4)](https://github.com/guilhermeblanco "guilhermeblanco (2 commits)")[![aaukt](https://avatars.githubusercontent.com/u/5297402?v=4)](https://github.com/aaukt "aaukt (1 commits)")[![markuspoerschke](https://avatars.githubusercontent.com/u/1222377?v=4)](https://github.com/markuspoerschke "markuspoerschke (1 commits)")[![cliveza](https://avatars.githubusercontent.com/u/1900666?v=4)](https://github.com/cliveza "cliveza (1 commits)")

### Embed Badge

![Health badge](/badges/instaclick-medusa/health.svg)

```
[![Health](https://phpackages.com/badges/instaclick-medusa/health.svg)](https://phpackages.com/packages/instaclick-medusa)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.6k509.9M17.0k](/packages/laravel-framework)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k36.7M259](/packages/laravel-dusk)[magento/magento2-functional-testing-framework

Magento2 Functional Testing Framework

15511.5M30](/packages/magento-magento2-functional-testing-framework)[magento/community-edition

Magento 2 (Open Source)

12.1k52.1k10](/packages/magento-community-edition)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)