Installing Helix Plan Web on macOS
Perform the following tasks to install and configure Helix Plan Web on macOS.
1. If nginx is not installed, install it using the following:
brew update
brew install nginx
2. Download and install an LTS version of node.js, v18 or later.
3. Download Helix Plan Web and unzip it to your desired install location.
4. In HelixPlanAPI
, rename config-example.env
to .env
.
5. Configure the server details in .env
as required.
nginx.conf
.6. Rename nginx-example.windows.conf
to nginx.conf
and make any necessary changes if required.
7. In .\certificates
, replace the existing certificate example with your own.
This can either be a certificate acquired from a certificate authority or a self-signed certificate, generated locally with OpenSSL. The following is an example for generating a self-signed certificate with OpenSSL:
openssl req -new -newkey rsa:2048 -nodes -days 365 -keyout .\certificates\web.key -out .\certificates\web.pem
Example certificates are provided, which you can use to get up and running. To use these, rename the example files to web.key
and web.pem
.
8. Copy client files to the web root directory - for example: /usr/local/var/www/
cp -r client/dist/* /usr/local/var/www/
cp -r integrations/helix_core /usr/local/var/www/
9. Copy certificates folder into the nginx
directory:
cp -r certificates /usr/local/etc/nginx/
10. To keep the /usr/local/etc/nginx/nginx.conf
file back it up and copy the example file:
cp nginx-example.conf /usr/local/etc/nginx/nginx.conf
11. Edit locations in nginx.conf
:
include /usr/local/etc/nginx/mime.types;
[...]
ssl_certificate /usr/local/etc/nginx/certificates/web.pem;
ssl_certificate_key /usr/local/etc/nginx/certificates/web.key;
[...]
root /usr/local/var/www/;
[...]
alias /usr/local/var/www/helix_core/htmlwindows.template;
12. Start nginx as a service:
brew services start nginx
13. Run ./start.sh
to start Helix Plan API.
14. Visit https://localhost
15. If you want to let users open the Helix Plan desktop client from the web client, set the hostname for the Helix Plan Server.