Installation of Phpwebsite for ESS Students

Installation

Setting up local repos

1. Clone repo into your projects folder git clone https://github.com/AppStateESS/phpwebsite.git
2. Ensure that PHP & Composer are installed run composer install within the phpwebsite 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 phpwebsite

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 phpwebsite directory. change permissions by chmod 755 to the corresponding folders.
2. Follow the configuration instructions. Note: for the ones using docker and phpwebsite 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.
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.

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>