Common Installations Errors

Common errors during local installation

On this page, you find the common errors that occur during the local installations of miniCal.

Q). Database installation is stuck?

Ans. If you are using Apache serve then do these configurations.

1. check if the rewrite module is enabled.

2. set apache2.conf AllowOverride All to your Directory

<Directory /var/www/>
    Options Indexes FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

If you are using Nginx then do these configurations. Check this link for more details https://github.com/minical/minical/blob/master/docker/nginx.conf.

        fastcgi_buffers 8 16k;       # default is 8 4k|8k
        fastcgi_buffer_size 32k;     # default is 4k|8k
        fastcgi_connect_timeout 60s; # default is 60s
        fastcgi_send_timeout 300s;   # default is 60s
        fastcgi_read_timeout 300s;   # default is 60s

location / {
        rewrite ^/api/(.*)$ /api/index.php?/$1 last;
        rewrite ^/public/(.*)$ /public/index.php?/$1 last;
        try_files $uri $uri/ /index.php?/$request_uri;
    }

Q). How to publish in apache 'api' point in the virtual host if "minical/public" and "minical/api" in the same directory?

Ans. For virtual host configuration, you can create two separate virtual hosts for Apache, something like this:

<VirtualHost *:80>
    DocumentRoot /var/www/html/minical/app/api/
    ServerName api.your-server.com
    CustomLog /usr/local/apache/logs/minical.io.access combined
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot /var/www/html/minical/app/public/
    ServerName app.your-server.com
    CustomLog /usr/local/apache/logs/minical.io.access combined
</VirtualHost>

Q). How to add extensions on local setup?

Ans. You can download a few Open source extensions here https://docs.minical.io/build-an-extension/open-source-extensions Put them in your local extensions directory located at "/minical/public/application/extensions/".

Q). SMTP settings and AWS keys are mandatory before DB installation?

Ans. No, these are not mandatory.