PHPackages                             ymcatwincities/openy-docksal - 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. [DevOps &amp; Deployment](/categories/devops)
4. /
5. ymcatwincities/openy-docksal

ActiveDocksal-vm[DevOps &amp; Deployment](/categories/devops)

ymcatwincities/openy-docksal
============================

Development Environment for Open Y based on open source tool http://docksal.io

152.8k↓31.8%10[2 issues](https://github.com/ymcatwincities/openy-docksal/issues)[1 PRs](https://github.com/ymcatwincities/openy-docksal/pulls)2PHP

Since Feb 20Pushed 3y ago9 watchersCompare

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

READMEChangelogDependenciesVersions (1)Used By (2)

This is a Docksal-based for the [YMCA’s Website Service](https://github.com/YCloudYUSA/yusaopenyy) Drupal distribution.

[Docksal](https://docksal.io/) is used as a local development environment.

Get Started
===========

[](#get-started)

You need to install Docksal on your local machine according to [Docksal setup](http://docksal.readthedocs.io/en/master/getting-started/env-setup/) instructions.

Full install from scratch
-------------------------

[](#full-install-from-scratch)

Note: a local instance of PHP and/or Composer is not required.

Follow these steps to get fully prepared project.

#### Install Docksal

[](#install-docksal)

```
curl -fsSL https://get.docksal.io | bash
```

#### Clone OpenY docksal project

[](#clone-openy-docksal-project)

```
git clone git@github.com:ymcatwincities/openy-docksal.git
```

#### Add your custom settings

[](#add-your-custom-settings)

- Create `docksal-local.env` file inside `.docksal` directory with content:

```
YUSAOPENY_PROJECT_VERSION='9.2.x'
YUSAOPENY_VERSION='9.x-2.x'
GIT_REMOTE_UPSTREAM='git@github.com:USER/yusaopeny.git'
IGNORE_CUSTOM='.idea'
```

- Use `OPENY_PROJECT_VERSION` to specify the branch of the `YCloudYUSA/yusaopeny-project` to be used as a composer project. In the most cases you'll need:

    - `9.2.x` for a last stable yusaopeny release.
    - `9.2.x-development` for a latest development yusaopeny.
- Use `YUSAOPENY_VERSION` to specify the branch of the `YCloudYUSA/yusaopeny` will be checkout automatically. Take in mind, the yusaopeny version corresponds the one, required in a root `composer.json`. Use `9.x-2.x` to start the development from the latest yusaopeny progress.
- Replace `USER` by your user name from github or remove `GIT_REMOTE_UPSTREAM`if you don't need an upstream repository to be set automatically.
- During an execution of a `build_project` command, all the directories except an ignored ones would be deleted. If you work on the existing project and want to save any folder in a project root directory - add folder name to `IGNORE_CUSTOM`. Directories names should be separated with spaces.

If you want to use your fork as an origin remote and the main repository as an upstream remote, add the following variables to the `docksal-local.env` file as follows:

```
GIT_REMOTE_UPSTREAM='git@github.com:YCloudYUSA/yusaopeny.git'
GIT_REMOTE_ORIGIN='git@github.com:USER/yusaopeny.git'
```

In this case, after project install git will already track the repositories you specified as `origin` and `upstream` remotes

#### Build Y USA Open YMCA project

[](#build-y-usa-open-ymca-project)

Run this command inside your project directory:

```
fin build_project
```

As a result you will get full YMCA’s Website Service installation in your file system.

The "Killed" message during command run usually means that you need to increase memory limits in your Docksal. For macOS or Windows overall memory volume available for Docker is limited by the virtual machine or Docker Desktop settings.

#### Install YMCA’s Website Service site

[](#install-ymcas-website-service-site)

After `fin build_project` command finish you need to install a site. For this you can use one of this commands:

- `fin init`
- `fin install_steps`
- `fin upgrade_init`

More details about these commands you can get below.

Alternative installation process
--------------------------------

[](#alternative-installation-process)

```
# Install Docksal
curl -fsSL https://get.docksal.io | bash
# Change directory to your workspace
fin run-cli composer create-project YCloudYUSA/yusaopeny-project yusaopeny --no-interaction --no-dev
cd yusaopeny
fin run-cli composer install
fin init
```

Open the URL printed at the end of the setup (e.g. `http://yusaopeny.docksal.site`) to see your local copy of the latest stable YMCA’s Website Service.

Docksal environment for YMCA’s Website Service
==============================================

[](#docksal-environment-for-ymcas-website-service)

Open the project's folder and run one of the commands.

Administrator account is *admin*:*admin*.

### Start the project

[](#start-the-project)

```
fin init
```

The webserver starts up, and the site will be installed automatically with `drush si`.

### Install site from UI

[](#install-site-from-ui)

```
fin install_steps
```

The webserver starts up and for site will be provided base configuration. After finish you need to open site in browser and continue installation from UI. This command is useful for testing YMCA’s Website Service install form.

### Testing Upgrade path

[](#testing-upgrade-path)

```
fin upgrade_init
```

The webserver starts up and the site will be installed from YMCA’s Website Service DB dump that contain pre-installed previous YMCA’s Website Service version. After installation will be executed all new updates that were added in the latest YMCA’s Website Service versions.

How to develop?
===============

[](#how-to-develop)

After you run the "fin init" and have your environment ready you need to do few things.

- Create a fork of .
- In your project go to `docroot/profiles/contrib/yusaopeny` and edit `.git/config` file. Replace repo URL to your newly created fork.
- Then you can create a branch in your repo, push some code and create a pull request back to `YCloudYUSA/yusaopeny` repo.

How to run behat tests?
=======================

[](#how-to-run-behat-tests)

Edit `behat.local.yml` and set `base_url` to `web` and `wd_host` to `http://browser:4444/wd/hub`. Then you can run your behat tests with `./vendor/behat/behat/bin/behat`.

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity33

Limited adoption so far

Community30

Small or concentrated contributor base

Maturity23

Early-stage or recently created project

 Bus Factor3

3 contributors hold 50%+ of commits

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.

### Community

Maintainers

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

![](https://www.gravatar.com/avatar/1388b312dca2d4c24fb3474c71a6729b13b255860ff0188b0286013bc703bf5a?d=identicon)[podarok](/maintainers/podarok)

![](https://www.gravatar.com/avatar/4558114408c700ee4fe122cf32e229c67e2a72a8da55256930a02685612572fa?d=identicon)[Open-Y-Distro](/maintainers/Open-Y-Distro)

---

Top Contributors

[![hamrant](https://avatars.githubusercontent.com/u/13733670?v=4)](https://github.com/hamrant "hamrant (19 commits)")[![podarok](https://avatars.githubusercontent.com/u/563412?v=4)](https://github.com/podarok "podarok (12 commits)")[![ygerasimov](https://avatars.githubusercontent.com/u/294265?v=4)](https://github.com/ygerasimov "ygerasimov (12 commits)")[![dimb](https://avatars.githubusercontent.com/u/2676631?v=4)](https://github.com/dimb "dimb (5 commits)")[![kolesnikoff](https://avatars.githubusercontent.com/u/2058068?v=4)](https://github.com/kolesnikoff "kolesnikoff (4 commits)")[![alexschedrov](https://avatars.githubusercontent.com/u/1316234?v=4)](https://github.com/alexschedrov "alexschedrov (4 commits)")[![mkdok](https://avatars.githubusercontent.com/u/14111296?v=4)](https://github.com/mkdok "mkdok (3 commits)")[![anprok](https://avatars.githubusercontent.com/u/16559938?v=4)](https://github.com/anprok "anprok (3 commits)")[![ddrozdik](https://avatars.githubusercontent.com/u/6285570?v=4)](https://github.com/ddrozdik "ddrozdik (3 commits)")[![NightHunterSV](https://avatars.githubusercontent.com/u/5138333?v=4)](https://github.com/NightHunterSV "NightHunterSV (1 commits)")[![dchubar-fj](https://avatars.githubusercontent.com/u/58946680?v=4)](https://github.com/dchubar-fj "dchubar-fj (1 commits)")[![taras-tsiuper](https://avatars.githubusercontent.com/u/1905435?v=4)](https://github.com/taras-tsiuper "taras-tsiuper (1 commits)")[![v1nk](https://avatars.githubusercontent.com/u/1905435?v=4)](https://github.com/v1nk "v1nk (1 commits)")[![AndreyMaximov](https://avatars.githubusercontent.com/u/5453109?v=4)](https://github.com/AndreyMaximov "AndreyMaximov (1 commits)")[![ygerasimov-imagex](https://avatars.githubusercontent.com/u/19168115?v=4)](https://github.com/ygerasimov-imagex "ygerasimov-imagex (1 commits)")[![YMCA-GTC](https://avatars.githubusercontent.com/u/17653329?v=4)](https://github.com/YMCA-GTC "YMCA-GTC (1 commits)")

### Embed Badge

![Health badge](/badges/ymcatwincities-openy-docksal/health.svg)

```
[![Health](https://phpackages.com/badges/ymcatwincities-openy-docksal/health.svg)](https://phpackages.com/packages/ymcatwincities-openy-docksal)
```

###  Alternatives

[deployer/deployer

Deployment Tool

11.1k25.4M207](/packages/deployer-deployer)[appwrite/server-ce

End to end backend server for frontend and mobile apps.

55.3k84.2k](/packages/appwrite-server-ce)[pragmarx/health

Laravel Server &amp; App Health Monitor and Notifier

2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[heroku/heroku-buildpack-php

Toolkit for starting a PHP application locally, with or without foreman, using the same config for PHP and Apache2/Nginx as on Heroku

8161.3M10](/packages/heroku-heroku-buildpack-php)[tiamo/phpas2

PHPAS2 is a php-based implementation of the EDIINT AS2 standard

4674.7k](/packages/tiamo-phpas2)

PHPackages © 2026

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