PHPackages                             20steps/bricks-installer - 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. 20steps/bricks-installer

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

20steps/bricks-installer
========================

The official installer to create projects based on the Bricks platform by 20steps.

v3.2.5(9y ago)021MITPHP &gt;=7.0.0

Since Dec 14Compare

[ Source](https://github.com/20steps/bricks-installer)[ Packagist](https://packagist.org/packages/20steps/bricks-installer)[ Docs](https://github.com/20steps/bricks-installer)[ RSS](/packages/20steps-bricks-installer/feed)WikiDiscussions Synced today

READMEChangelogDependencies (5)Versions (6)Used By (0)

Bricks Installer
================

[](#bricks-installer)

[![Build Status](https://camo.githubusercontent.com/b1be87ce490196fe46d147a182c5e8c25d91e98a8d8887a24ce2496143836a15/68747470733a2f2f7472617669732d63692e6f72672f323073746570732f627269636b732d696e7374616c6c65722e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/20steps/bricks-installer)[![Tested PHP versions](https://camo.githubusercontent.com/f1e0b79d856eb34e8541f0f895d735c2b3203b9f9b331bac96596ab05fb8be09/687474703a2f2f7068702d6579652e636f6d2f62616467652f323073746570732f627269636b732d696e7374616c6c65722f7465737465642e737667)](https://travis-ci.org/20steps/bricks-installer)[![Dependency Status](https://camo.githubusercontent.com/8509ec6555b070f3c7a31ed0980fbbb7d1053d7acab70d536aa505d126a13c2e/68747470733a2f2f7777772e76657273696f6e6579652e636f6d2f757365722f70726f6a656374732f3538353432643533616439616132303033333136626332372f62616467652e7376673f7374796c653d666c61742d737175617265)](https://www.versioneye.com/user/projects/58542d53ad9aa2003316bc27)[![Packagist version](https://camo.githubusercontent.com/2a00f341d63cad32c8a3313235e1f3519acea5ecf132a70f11ceb52f2d561e72/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f323073746570732f627269636b732d696e7374616c6c65722e737667)](https://packagist.org/packages/20steps/bricks-installer)

**This is the official installer to start new projects based on the [**Bricks platform by 20steps**](https://github.com/20steps/bricks-platform-standard-edition).**

Installing the installer
------------------------

[](#installing-the-installer)

This step is only needed the first time you use the installer:

### Linux and Mac OS X

[](#linux-and-mac-os-x)

```
$ sudo curl -LsS https://bricks.20steps.de/downloads/installer -o /usr/local/bin/bricks
$ sudo chmod a+x /usr/local/bin/bricks
```

### Windows

[](#windows)

```
c:\> php -r "file_put_contents('bricks', file_get_contents('https://bricks.20steps.de/downloads/installer'));"
```

Move the downloaded `bricks` file to your projects directory and execute it as follows:

```
c:\> php bricks
```

If you prefer to create a global `bricks` command, execute the following:

```
c:\> (echo @ECHO OFF & echo php "%~dp0bricks" %*) > bricks.bat
```

Then, move both files (`bricks` and `bricks.bat`) to any location included in your execution path. Now you can run the `bricks` command anywhere on your system.

Installing without the Installer
--------------------------------

[](#installing-without-the-installer)

If you can't use the Bricks Installer for any reason, you can create Bricks applications with [**Composer**](https://getcomposer.org/), the dependency manager used by modern PHP applications.

If you don't have Composer installed in your computer, start by installing Composer globally.

Then, execute the create-project command to create a new Bricks application based on its latest stable version:

```
composer create-project 20steps/bricks-platform-standard-edition my_project_name
```

To create a new Bricks application based on the latest non-stable version execute:

```
composer create-project 20steps/bricks-platform-standard-edition my_project_name dev-master
```

Using the installer
-------------------

[](#using-the-installer)

**1. Start a new project with the latest stable Bricks version**

Execute the `new` command and provide the name of your project as the only argument:

```
# Linux, Mac OS X
$ bricks new my_project

# Windows
c:\> php bricks new my_project
```

**2. Start a new project with the latest Bricks LTS (Long Term Support) version**

Execute the `new` command and provide the name of your project as the first argument and `lts` as the second argument. The installer will automatically select the most recent LTS (*Long Term Support*) version available:

```
# Linux, Mac OS X
$ bricks new my_project lts

# Windows
c:\> php bricks new my_project lts
```

**3. Start a new project based on a specific Bricks branch**

Execute the `new` command and provide the name of your project as the first argument and the branch number as the second argument. The installer will automatically select the most recent version available for the given branch:

```
# Linux, Mac OS X
$ bricks new my_project 2.8

# Windows
c:\> php bricks new my_project 2.8
```

**4. Start a new project based on a specific Bricks version**

Execute the `new` command and provide the name of your project as the first argument and the exact Bricks version as the second argument:

```
# Linux, Mac OS X
$ bricks new my_project 2.8.1

# Windows
c:\> php bricks new my_project 2.8.1
```

**5. Install the Bricks demo application**

The Bricks Demo is a reference application developed using the official Bricks Best Practices:

```
# Linux, Mac OS X
$ bricks demo

# Windows
c:\> php bricks demo
```

Updating the installer
----------------------

[](#updating-the-installer)

New versions of the Bricks Installer are released regularly. To update your installer version, execute the following command:

```
# Linux, Mac OS X
$ bricks self-update

# Windows
c:\> php bricks self-update
```

> **NOTE**
>
> If your system requires the use of a proxy server to download contents, the installer tries to guess the best proxy settings from the `HTTP_PROXY` and `http_proxy` environment variables. Make sure any of them is set before executing the Bricks Installer.

Troubleshooting
---------------

[](#troubleshooting)

### SSL and certificates issues on Windows systems

[](#ssl-and-certificates-issues-on-windows-systems)

If you experience any error related with SSL or security certificates when using the Bricks Installer on Windows systems:

1. Check that the OpenSSL extension is enabled in your `php.ini` configuration:

```
; make sure that the following line is uncommented
extension=php_openssl.dll
```

2. Check that the path to the file that contains the security certificates exists and is defined in `php.ini`:

```
openssl.cafile=C:/path/to/cacert.pem
```

If you can't locate the `cacert.pem` file anywhere on your system, you can safely download it from the official website of the cURL project:

Author
------

[](#author)

- Helmut Hoffer von Ankershoffen ()

Sponsored by
------------

[](#sponsored-by)

[20steps - Digital Full Service Boutique](http://20steps.de)

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity62

Established project with proven stability

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 ~4 days

Total

5

Last Release

3470d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b7601e5458b38b514ef7c696075cb349670c50ec0a8a1f8440b68b6df32f230a?d=identicon)[helmuthva](/maintainers/helmuthva)

---

Tags

phpinstallerplatformbricks

### Embed Badge

![Health badge](/badges/20steps-bricks-installer/health.svg)

```
[![Health](https://phpackages.com/badges/20steps-bricks-installer/health.svg)](https://phpackages.com/packages/20steps-bricks-installer)
```

###  Alternatives

[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.2k532.1M2.5k](/packages/aws-aws-sdk-php)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19664.8M1.6k](/packages/drupal-core)[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

101466.4k45](/packages/friendsoftypo3-content-blocks)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

6941.5M398](/packages/drupal-core-recommended)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[shlinkio/shlink

A self-hosted and PHP-based URL shortener application with CLI and REST interfaces

5.1k4.9k](/packages/shlinkio-shlink)

PHPackages © 2026

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