What is a Browser Container?
A Browser Container is an newly developed container asset that turns the VNC button into either a Chrome or Firefox web browser.
If your group is using or developing a browser-based application, but you aren’t allowed to host this app on the open internet, then a browser container is the way to go!
With a browser container, you can use CONS3RT as your authentication method, and you can host your app on the CONS3RT user-net. Instead of deploying a system and manually downloading a browser, this asset will take you directly to a URL of your choice on Chrome or Firefox.
How to build a Browser Container
To set up your browser container:
- Clone this system: (https://app.arcus-cloud.io/#/systems/124740/overview) or if you’re familiar with constructing your own systems, use this Asset (https://app.arcus-cloud.io/#/containers/121506/overview) and follow the instructions in the readme
Note: If you’re not sure how to clone a system please see this KB article for assistance.
- Enter the System Builder to customize your cloned system
- Start by giving your new system a name and click next
- Edit system settings as desired, then click next
- Under Install Assets find the environmental variables section under the Container Asset
- Set your landing page to the desired URL next to the HOMEPAGE key (in this example, set to https://www.google.com)
- Choose your browser (either “chrome” or “firefox”) and input this browser information next to the RABROWSER key > Note: The fields in #6 and #7 are required for the browser container to work as designed.
- Finish your system!
- You can either launch your run from the completed system as a quickbuild, or go through the full process and create a scenario, then a deployment before launching.
Example Browser Container Asset Settings
- Container Runtime: Docker Container Runtime
- Name: browser
- Additional Arguments: –tty –restart always –shm-size=512m –security-opt seccomp=chrome.json
- Key HOMEPAGE Value https://hmc.hpc.mil
- Key RABROWSER Value chrome
- Host IP:Port 5902 Container Port 5900 TCP
- Host IP:Port 22 Container Port 22 TCP
Available Environment Variables
- The webpage that is launched by the container
- example: HOMEPAGE=https://arcus-cloud.io
- The width of the browser
- default: 1920
- example: SCREEN_WIDTH=1920
- The height of the browser
- default: 1080
- example: SCREEN_HEIGHT=1080
- The browser to use
- options: firefox or chrome
- example: RABROWSER=chrome
Using the Browser Container
Once your launched run is available, simply connect to your deployment run through VNC and you will be directed to the browser and URL defined above.
Bear in mind that if you connect via SSH, you will be connecting to the Container itself and not the host operating system. The container binds to port 22 and will prevent the remote access ssh button from connecting to the host machine.
If you need to make changes to the host OS, you will have to SSH from another system on port 2200
If you download something from the browser and would like to transfer it over to your home machine:
- Open the onscreen clipboard via ctrl/alt/shift,
- Select the drive under the text box
- Find downloads in the browser folder in the home directory
- Double click the file
This should download it to the browser on your local machine.
If you can’t answer your question by perusing this KB, please feel free to submit a support ticket to email@example.com
To see the concepts discussed in this article in action, consider watching our YouTube tutorial: