Questions

Some common problems that you may encounter when setting up and using this software.

Having trouble when installing?

It is possibly because you have not given the program write access to save the configuration file. Please run the following command in your Avocado root folder.

$ chmod -R 777 avocado/partials && chmod -R 777 avocado/assets/uploads

Having trouble uploading attachments?

It is possibly because you have not given the program write access to the uploads folder. Please run the following command in your Avocado root folder.

$ chmod -R 777 avocado/partials && chmod -R 777 avocado/assets/uploads

It is also probably because the uploaded file size is exceeding the set value of your system. You will need to update the settings for your Nginx and PHP.

$ sudo nano /etc/nginx/nginx.conf

# Change the following value in this document to a large value such as 200M
client_max_body_size 200M;

$ sudo systemctl reload nginx

$ sudo nano /etc/php/7.2/fpm/php.ini

# Change the following value in this document to a large value such as 200M
upload_max_filesize = 200M;
post_max_size = 200M;

$ sudo service php7.2-fpm restart

$ sudo add-apt-repository ppa:ondrej/php
$ sudo apt update
$ sudo apt install php7.2-fpm php7.2-gd php7.2-curl php7.2-mysql php7.2-dev php7.2-cli php7.2-common php7.2-mbstring php7.2-intl php7.2-zip php7.2-bcmath

Please check if you have the required PHP extensions and some common PHP extensions installed. If not, feel free to copy and run the following commands.

Can't update the software through the admin panel?

Please check if you have changed the ownership of your Avocado project folder to www-data:www-data. If not, do the following to change.

$ chown -R www-data:www-data avocado

Some systems use www as their web server user. In this case, you want to change the owner of the folder to www.

chown -R www:www avocado

Attachments accessible without logging in?

If you are using Nginx server, please add the following line in your website settings. If you are using Apache, the solution should be similar - do some quick research :)

rewrite ^/assets/uploads/(.*) /attachment?file=$1 break;

Getting HTTP 500 errors?

Please check if you have the required PHP extensions and some common PHP extensions installed. If not, feel free to copy and run the following commands.

$ sudo add-apt-repository ppa:ondrej/php
$ sudo apt update
$ sudo apt install php7.2-fpm php7.2-gd php7.2-curl php7.2-mysql php7.2-dev php7.2-cli php7.2-common php7.2-mbstring php7.2-intl php7.2-zip php7.2-bcmath

PHP script is not executing but being downloaded?

In you php.ini file, make sure short_open_tag is turned on. Mine is located at /etc/php/7.2/fpm/php.ini.

$ sudo nano /etc/php/7.2/fpm/php.ini

How to enable "Sign in with Google"?

Go to the Google API Console.

• Select an existing project from the projects list, or click NEW PROJECT to create a new project:

  • Enter the Project Name.

  • Under the Project Name, you will see the Google API console automatically creates a project ID. Optionally you can change this project ID by the Edit link. But project ID must be unique worldwide.

  • Click on the CREATE button and the project will be created in some seconds.

• In the left side navigation panel, select Credentials under the APIs & Services section.

• Select the OAuth consent screen tab, specify the consent screen settings.

  • In Application name field, enter the name of your Application.

  • In Support email filed, choose an email address for user support.

  • In the Authorized domains, specify the domains which will be allowed to authenticate using OAuth.

  • Click the Save button.

• Select the Credentials tab, click the Create credentials drop-down and select OAuth client ID.

  • In the Application type section, select Web application.

  • Authorized JavaScript origins - your Avocado instance domain.

  • Authorized redirect URIs - your Avocado instance domain + "/redirect".

    • For example, if your instance domain is https://demo.avocado.vc, then you should add the following URI as an Authorized redirect URI: https://demo.avocado.vc/redirect

  • Click the Create button.

A dialog box will appear with OAuth client details, note the Client ID and Client secret. This Client ID and Client secret allow you to access the Google APIs.

How to enable email notifications (e.g. invites and password recovery emails)?

To enable the platform to send emails to the users, you will need to have an SMTP server. You can send the emails through Gmail's SMTP server with your Gmail account or use services such as Mailgun to send through your custom domain email.

To use Gmail to send emails, feel free to check out the following article.

How to Use the Gmail SMTP Server to Send Emails for FreeKinsta®

To use Mailgun to send emails (highly recommended), feel free to check out this tutorial video. It is super easy to set up, and the service is fairly reliable.

Cannot upload/update user profile image or download documents as Word?

Please check if you have the required PHP extensions installed and enabled. Required extensions include:

fileinfo, imagemagick, exif