Installation instructions (+ corrections) specific to Debian

quenenni commented 4 years ago

I give you all the command I had to do in order to install agorakit. There was a problem in the middle of the process, based on your documentation, but I found a solution.

Requirements:

apt install git composer mariadb-server php php-bcmath php-xml php-tokenizer php-mysql php-gd

cloning the app:

cd /var/www
git clone https://github.com/agorakit/agorakit
cd agorakit/
cp .env.example .env

edit the .env file to adapt to your system / configuration

Download all the package needed: Unfortunately, the command sudo -u www-data composer install (tried also with user root) returned an error

Problem 1
- Installation request for ddeboer/imap 1.10.0 -> satisfiable by ddeboer/imap[1.10.0].
- ddeboer/imap 1.10.0 requires ext-imap * -> the requested PHP extension imap is missing from your system.

I tried to install the ddboer/imap app with the command sudo -u www-data composer require ddeboer/imap (tried also with root), but had the exact same error.
- To be able to successfully install that app, I had to install the Php extension imap first:
```
apt install php-imap
```
- Now I had another error while trying to install ddbor/imap app
```
The following exception is caused by a lack of memory or swap, or not having swap configured
Check https://getcomposer.org/doc/articles/troubleshooting.md#proc-open-fork-failed-errors for details
```

In Process.php line 344:

proc_open(): fork failed - Cannot allocate memory


  * To fix that problem, I had to create a swap:

/bin/dd if=/dev/zero of=/var/swap.1 bs=1M count=1024 /sbin/mkswap /var/swap.1 chmod 0660 /var/swap.1 /sbin/swapon /var/swap.1

  And now it worked

- All the next commands in your documentaion worked first try.

sudo -u www-data composer install php artisan key:generate php artisan migrate php artisan storage:link


- A simple vhost in apache and I could access the app. <br>
But now I need a better vhost because all the links on the index page return a 404 (as described in the other ticket)

Hope this help.

philippejadin commented 4 years ago

This is very detailed, thank you!

The install doc assume you have a working lamp server ready to accept a php application with composer. Imho server setup is out of scope for the doc but I'm open to change my mind :-)

For example, look at the laravel install docs : https://laravel.com/docs/7.x

quenenni commented 4 years ago

added php-gd to the instructions.

agorakit / documentation

Installation instructions (+ corrections) specific to Debian #2