Setup Guide to install Fusio with Nginx?

[bi...@abinfo.de]

Hallo,

multiple days I have tried to install Fusio on an VPS with Ubuntu and Nginx - without success. Now I have given up.
Only manual step to create database schema on my own MySQL server works as expected. Creation of administrative user seems also to work. But there is no backend available in the apps folder.

I'm not an IT expert and have not deep knowledge.

Searching for an easy-to-use open-source solution for API management and thought Fusio could be the right one.

Is there a chance, that a setup guide for Nginx will be available soon - saw that others are also waiting for it?

Best regards, Andreas

[Christoph Kappestein]

Hi Andreas,

currently we have the following documentations s. https://fusio.readthedocs.io/en/latest/basic/installation.html#setup

Since we mostly use Apache via Docker we dont have currently an explicit Nginx documentation but it should be also easy possible, since Fusio has no special requirements.

Maybe you can take a look at the Symfony examples s.

https://symfony.com/doc/current/setup/web_server_configuration.html#nginx

But we also plan to add a documentation regarding Nginx. Regarding the installation, please let us know where you have experienced problems so that we can

improve our documentation.

best regards

Christoph

[bi...@abinfo.de]

Hi Christoph,

have set up my server from scratch, installed Nginx and php7.4 modules. Now have done a new try with standard settings (not as the 1st time when I have created a separate site and used a self-signed certificate to direcly using https). Now the install.php seems to work generally. Steps 1-3 pass successfully but it stopped at step 4 with the following error:

Is it correct that $homeDir points to /var/www folder and the token should be stored there?
Should I give the www-data user permissions on this folder (I have given them permissions below /var/www/html by now)?

Best regards

Andreas

[bi...@abinfo.de]

Hi Christoph,

after posting the issue at step 4 of the install.php I have made www-data owner of /var/www/html too. Now this step has been passed successfully. Next issue occurs now at step 5:

I fear when installing backend app later also steps 7-8 are still missing.

Any idea how I can fix error with class "ZipArchive"?

Best regards

Andreas

[bi...@abinfo.de]

Hi,

have found solution myself: install php zip module 😉

Now the install.php completed successfully 👍

Best regards

Andreas

[bi...@abinfo.de]

Hi Christoph,

generally the installation now looks fine. Have also downloaded the last master version of the backend-scripts.
But the authentication issue still exists (as posted in git by other users). Hopefully there is a solution soon available.

Best regards

Andreas

[Christoph Kappestein]

Hi Andreas,

in general the problems regarding the login should be resolved with the latest 2.0.1 version. Could you check at the index.html file of the backend that the ${API_URL} is correctly substituted with the Fusio API url, normally this is done automatically on installation but since your installation has failed it was probably not replaced.

best regards

Christoph

[bi...@abinfo.de]

Hi Christoph,

thanks a lot for your support. Now I could solve all my current issues. Here some important information (maybe helpful for others):

• When downloading fusio-apps-backend directly from Github and store it in the apps/fusio folder the index.html has to be substituted as you mentioned: Replacing the ${API_URL}. Example:
  
  fusioProvider.setBaseUrl('http://base-url/index.php/');
  
  
• Alternatively found out, that using the marketplace installation procedure directly sets the value correct:
  
  php bin/fusio marketplace:install fusio
  
  
• Addionally for Nginx I had to adapt the configuration file a bit different to the Symfony example of your first answer to this post:
  
  try_files $uri $uri/ /index.php$is_args$args;
  
  

At lease for the momemt I'm happy that Fusio now is running successfully on my own VPS with Nginx 😁.

My next challenge is to move the installation to a separate site (currently have used the default) and to integrate a certificate to improve security by using https.

Best regards

Andreas

[Christoph Kappestein]

Hi Andreas,

great to hear that the installation now works. If you have any questions or ideas regarding Fuiso please let me know.

best regards

Christoph

[bi...@abinfo.de]

Hi Christoph,

have now also moved Fusio to a separate Nginx site and installed a certificate by Certbot successfully.
After adapting the base url in the index.php of the backend app form http to https the login works again🙂

Best regards

Andreas

[Patrick Riviere]

Do you know when this documentation will be added? I have still some trouble to install fusio with nginx.

My last install with apache on VPS was a drama, but I cannot follow the steps to make this work with nginx.

Thanks, for your help,

Patrick

[Christoph Kappestein]

Hi Patrick,

Iam currently really busy so I have not the time to write such an article but maybe Andreas could help you, it looks like he has a working Nginx configuration.

As mentioned https://symfony.com/doc/current/setup/web_server_configuration.html#nginx is probably a good starting point.

Also everyone is welcome to create a PR with a short description at https://github.com/apioo/fusio/blob/master/doc/setup/nginx.rst so please

let me know if someone wants to create such an article.

best regards

Christoph

[Andi Biker]

Hi Patrick, hi Christoph,

hopefully in the next days I have some time to document my experience with installing fusio on nginx and share thist with you.

Best regards

Andreas

[vinit furia]

I have a working instance on NGINX but would someone be greatful enough for helping me with directives for redirection as nginx doesnt use .htaccess file system.

Kindly if possible please help me out with redirection.

I have made it work with api but documentation /developer account/Swagger are not working. As it always passes to public folder

[John Lirac]

Hi vinit! Have you had workaround here? I am having same issue