Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Version History

« Previous Version 3 Next »

Install nginx

brew install nginx

Depending on how homebrew configures nginx you may end up with either of the following:

Document root for placing files is: /usr/local/var/www OR /opt/homebrew/var/www

Site configs go in /usr/local/etc/nginx/servers/ OR /opt/homebrew/etc/nginx/servers/

Start nginx with brew services start nginx and stop it with brew services stop nginx

Add Hosts file entry

nano /etc/hosts

127.0.0.1        helium.stb.mezzanineware.com
127.0.0.1        app.stb.mezzanineware.com

You can add a domain of your choice but that will require changes to some of the attached files.

Configure Dual Setup

Copy the attached helium.conf file into /opt/homebrew/etc/nginx/includes/ (you might have to create the includes directory)

Copy the attached 001-helium.stb.mezzanineware.com & 002-app.stb.mezzanineware.com files into /opt/homebrew/etc/nginx/servers/

Create the following directory structure within /opt/homebrew/var/www/:

├── helium
│   └── web-client
└── helium-ui
    └── dist

Copy the web-client directory from the old ui project to the web-client directory you just created. Do the same for the new ui project by copying the dist directory. You will need to build both projects for production before you copy the contents, you can do so as follows:

Old UI - navigate into the frontend directory and run npm run test

New UI - navigate to the root directory and run npm run build

you can then use the following commands to copy the relevant directories:

Old UI - cp -R /path/to/project/appexec-dsl-web-ui/frontend/dist/web-client/ /opt/homebrew/var/www/helium/web-client/

New UI - cp -R /path/to/project/helium-ui/dist/ /opt/homebrew/var/www/helium-ui/dist/

Update heliums' docker-compose

Navigate to the docker-compose.yml file located in the root of the helium code base.

Update the backend ports from 8080:8080 to 8084:8080

Run Helium

Now that you are setup you can run your local helium setup as normal. Once it is fully up and running you will need to stop the UI container in docker desktop.

Once that has stopped you can start your local nginx.

Navigating to helium.stb.mezzanineware.com should now serve up the production compiled code from your local nginx setup.

Setup your FQDN

Once logged in to helium admin you can setup an app of your choice to use the FQDN which we set in your hosts file - app.stb.mezzanineware.com

  • No labels