Canopy Installation

Installation

Setting up local repos

1. Clone repo into your projects folder git clone https://github.com/AppStateESS/canopy.git
2. Ensure that PHP & Composer are installed run composer install within the Canopy directory. Note: There is a good chance you will have to install other software here

Setting up Docker

1. Install Docker Engine
2. Install Docker Compose
3. Expand permissions for Docker by making a group. Don't forget to restart for this to take effect.
4. Run docker-compose build
5. Run docker-compose up -d to start the containers. Note: you will have to do this every time you start up your machine.

Configuring Canopy

1. head to localhost:8080 and initialize a config Note: At this point you may need to adjust your permissions on the folders within your canopy directory. change permissions by chmod 755 to the corresponding folders. If at any time you need to restart the setup go into /config/core/ and delete all of the following files.
2. Follow the configuration instructions. Note: for the ones using docker and canopy as a development build while configuring, note that your database location will not be localhost. There are three running containers: one for web, one for mysql, and one for postgresql. If you want mysql then the host will be mysql_db otherwise use postgres_db. For projects like slideshow, leave the port section blank in the setup.
3. If you encounter an error with install you may have to delete your config file from the config folder in order to attempt the install again.
4. If at any time you change the permissions of a folder and still the setup is giving you errors. Follow Connecting to the database and add the folders or change the permissions in the docker container.

Using Modules

• This is a good time to install Node sudo apt-get install npm (Ubuntu)
• This is also a good time to install themes that correspond to each unique module git clone <repo_url>