PHPackages                             shedhost/shed - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. shedhost/shed

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

shedhost/shed
=============

simple local PHP development

1.3.3(9y ago)3222Apache-2.0PHP

Since Sep 4Pushed 8y ago1 watchersCompare

[ Source](https://github.com/shedhost/shed)[ Packagist](https://packagist.org/packages/shedhost/shed)[ RSS](/packages/shedhost-shed/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (10)Used By (0)

Shed
====

[](#shed)

simple local PHP development

**WARNING: This project started as a PHP project and is still in the process of being ported to Javascript. The Javascript version is mostly untested, unfinished, and undocumented. You might want to wait.**

Quick Start
-----------

[](#quick-start)

1. You need [Docker](https://www.docker.com/) and [NPM](https://www.npmjs.com/) installed.
2. `npm install -g shed-host`
3. Edit your shed .env to specify your sites folder.
4. `shed up -d`

Introduction
------------

[](#introduction)

Shed provides a platform for simple, local, PHP development, in the same kind of way MAMP, Laravel Valet, or Homestead does.

- Shed uses Docker, and runs on **every platform** Docker does.
- Shed treats **folders as sites**, so adding a site is just making a folder.
- Shed makes use of **wildcard DNS**, so **no configuration** is required to add sites to Shed.
- Shed runs real Linux, Apache, MySQL, PostgreSQL and PHP, so your local environment matches production.

It's designed to provide a set-it-and-forget-it platform for local, PHP development.

Setup
-----

[](#setup)

To run Shed, you only need to be able to run [Docker](https://www.docker.com/) and [NPM](https://www.npmjs.com/). Shed is not tested on Windows yet, but Shed plans to support Windows, Linux, and OS X.

### Default Enviroment

[](#default-enviroment)

There is a `.env` file in the shed's directory that must be edited by hand for now, until `shed config` is ported over from the PHP version.

Usage
-----

[](#usage)

Start Shed by running `shed up` or `shed up -d`. Once it's running, you can access your projects based on their folder names. For example, To access `Projects/example.com`, I would go to

-

That's it. If you don't want to use shed.host, you can use any of the following:

- imarc.io - owned by [Imarc](https://www.imarc.com)
- localtest.me - [readme.localtest.me](http://readme.localtest.me/)
- lvh.me - owned by [Levi Cook](https://gist.github.com/levicook/563675)
- 42foo.com - owned by [Jorge Bernal](https://jorgebernal.info/2009/07/17/42foo-virtual-hosts-web-development/)
- fuf.me - owned by [fidian](http://www.fidian.com/programming/public-dns-pointing-to-localhost)
- lacolhost.com - owned by [Reenhanced](http://blog.reenhanced.com/post/29566591244/developing-with-subdomains-just-got-a-lot-easier)
- vcap.me - part of [Cloud Foundry](https://github.com/cloudfoundry-attic/vcap)

**Shed assumes** that the document root for all your projects is `/public`. If you use `docroot/` instead, you can try creating a symlink like this:

```
$ ln -s public docroot

```

### How this works

[](#how-this-works)

\*.shed.host is setup using wildcard DNS to point to `127.0.0.1` - one of the IPs designed to always point to your own local system (*localhost*.) This eliminates any need to etc your `/etc/hosts` file.

Within Shed's apache container, it uses `mod_vhost_alias` to map these subdomains back to separate virtualhosts. This means that there's no new apache configuration required.

### Special Subdomains

[](#special-subdomains)

There are two groups of special domains:

1. [shed.host](http://www.shed.host) and [www.shed.host](http://www.shed.host) get you to Shed's website.
2. [my.shed.host](http://my.shed.host) and [shed.shed.host](http://shed.shed.host) get you to Shed's local, internal site. This is where you can find Adminer and Webgrind.

Adminer
-------

[](#adminer)

[Adminer](https://www.adminer.org/) is a lightweight webapp for managing databases, including both MySQL and PostgreSQL. The latest release of Adminer is included in Shed.

You can login by going to  and clicking the relevant link, or:

- **MySQL:** host is `mysql`, username is `root`, no password
- **PostgresSQL:** host is `postgres`, username is `postgres`, no password

XDebug and Webgrind
-------------------

[](#xdebug-and-webgrind)

XDebug and Webgrind are setup within Shed as well. You can trigger XDebug profiling by adding `?XDEBUG_PROFILE=1` to the end of a URL.

You can view That profile with Webgrind by going to

-

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 93.9% 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 ~27 days

Recently: every ~51 days

Total

9

Last Release

3368d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/4c423d4aa457201693aadc0ffd67895f3383709e89c66547949d65a37123ee22?d=identicon)[khamer](/maintainers/khamer)

---

Top Contributors

[![khamer](https://avatars.githubusercontent.com/u/1452?v=4)](https://github.com/khamer "khamer (77 commits)")[![jeffturcotte](https://avatars.githubusercontent.com/u/65089?v=4)](https://github.com/jeffturcotte "jeffturcotte (5 commits)")

### Embed Badge

![Health badge](/badges/shedhost-shed/health.svg)

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

###  Alternatives

[mileschou/twnicip

Twnic IP

131.9k](/packages/mileschou-twnicip)

PHPackages © 2026

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