# Access from Web Browser

## Overview

After the 2025 Stronghold HyperV migration, all Linux workstations must be accessed via a web browser.

## Connecting via a Web Browser

NOTE: Users on campus must be connected to the Brown WiFi or a wired connection in a research building. Off-campus users can access their environments by connecting through the [Brown VPN](https://it.brown.edu/services/virtual-private-network-vpn).

### 1. Log in with your web browser 

Point a web browser to your tenant page at **https\://`<tenant>`.stronghold.brown.edu**

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2FgGUS1SgIhP7SZbXomDHj%2Fimage.png?alt=media&#x26;token=a8663fab-c863-4226-98b1-89ad12202eea" alt=""><figcaption></figcaption></figure>

Enter your Brown credentials and select Login.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2FraHqI4nkztnGcFr3BOju%2Fimage.png?alt=media&#x26;token=176ceb56-75b7-4dfe-81e6-13ac62ed5f0f" alt="" width="563"><figcaption></figcaption></figure>

Select a Duo option for two-factor verification. Type the number of your choice and select `Submit`.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2F2KJHd2D2KPpLiUpUG56W%2Fimage.png?alt=media&#x26;token=f5562804-9cde-46f6-af48-5ca6150bab26" alt="" width="563"><figcaption></figcaption></figure>

Click the `Proceed` button to move forward.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2FvewSulhuFf1eD0edYMFY%2Fimage.png?alt=media&#x26;token=3339211d-5bf9-4c44-8afa-3a38c4365bf9" alt="" width="563"><figcaption></figcaption></figure>

### 2. Start a Session

After completing Duo verification, you’ll be taken to the session window. Any active sessions would appear here, but since this is your first login, you’ll need to start a new one.

Select the **"Desktop"** bookmark and click it to launch your session.

> **Note:** The **"Terminal"** option is intended for advanced users comfortable working from the command line.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2FfFP6F66hPDu5U1eju9iM%2Fimage.png?alt=media&#x26;token=cab1421e-acb6-4996-81b7-d51057d9e677" alt="" width="563"><figcaption></figcaption></figure>

Then, click on **Browser Client**. Currently, only the browser client is supported.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2FtracGUPO4bynf6RcAsDl%2Fimage.png?alt=media&#x26;token=3f63b044-7b39-48ad-8c8f-938fcf0869bd" alt=""><figcaption></figcaption></figure>

Tenants with multiple Linux workstations will be prompted to select a server. Talk to your PI or tenant admin for more information.

![Tenants with multiple workstations can select their session server.](https://240799936-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWdZhwLCll1J0u091B%2F-MWewAR-DkbqB27Y3UxK%2F-MWewEfrSwDmfVLOnt1U%2F210325105923.png?alt=media\&token=730b5fd1-e25a-4329-ad6d-16e3dc0862c1)

### 3. Navigate Environment

A dropdown menu of applications is found in the top-left of the desktop environment under "Stronghold".

![The Stronghold dropdown menu.](https://240799936-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWdZhwLCll1J0u091B%2F-LtWJurst5ro4vBx0V6q%2F-LtWK1tVoShzp6dNbBUW%2Fimage.png?alt=media\&token=ee64e4a9-e515-4c74-b0b7-1244a5d0781a)

If you click the terminal icon from the Stronghold dropdown, you’ll open a new terminal window. In it, you can load [software modules](https://docs.ccv.brown.edu/stronghold/software/linux-standard-software#software-modules), [Conda environments](https://docs.ccv.brown.edu/stronghold/software/linux-standard-software#environment-modules), and run other commands. Expect to do most of your work here.&#x20;

Note: you can only run one desktop session per workstation. Launching additional sessions will automatically terminate any other running sessions.&#x20;

### 4. Exit/Leave a Session&#x20;

**To save your session and disconnect:** exit out of your browser window or tab.&#x20;

**To terminate your session:**

* In the Stronghold dropdown menu, select `Log Out`.&#x20;

![The application menu "Log out" option.](https://240799936-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWdZhwLCll1J0u091B%2F-MWf43G05xC55nixbTW3%2F-MWf4ySi8a8o09LC8KpM%2F210325110505.png?alt=media\&token=b2e7034a-bd89-4ca8-8901-8d4c188ce8ec)

* Then click the "Log Out" button.

![To terminate your session, click "Log Out".](https://240799936-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LcWdZhwLCll1J0u091B%2F-MWexMpGmWUsNN80BUOG%2F-MWeyjSKhp3qh8No4Uu-%2F210325152411.png?alt=media\&token=781eec85-c33f-431a-b76a-269a789f713d)

{% hint style="danger" %}
Logging out will terminate your running applications. You may lose any work that hasn't been saved.
{% endhint %}

### 5. Reconnect to Linux Workstation

If you lose connection to your **Stronghold Linux workstation**, you can safely reconnect without losing any data or environment settings.

To reconnect:

1\) Close the browser tab of your previous session.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2F88cwkXpJJM7M4KMnAqJP%2Fimage.png?alt=media&#x26;token=4bb78b2f-8dbb-479a-9a19-ff1b1df5f29c" alt=""><figcaption></figcaption></figure>

2\) Open a new browser tab and navigate to:

```
https://<tenant>.stronghold.brown.edu
```

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2FhSOmPMdexEGUuZJ0gQPD%2Fimage.png?alt=media&#x26;token=6c9e14cb-073b-4859-b537-94ee94baa275" alt=""><figcaption></figcaption></figure>

3\) On the dashboard, click one of the “Disconnected Sessions.”

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2Fp6DPRSg2nNGukMvJaiQr%2Fimage.png?alt=media&#x26;token=ff75195b-1fb3-4c6a-bb29-780702fefb3a" alt=""><figcaption></figcaption></figure>

4\) Select Browser Client to reopen your session.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2FR5DUPifpVEZnlo0tkDg8%2Fimage.png?alt=media&#x26;token=83dadc5d-3788-4efe-bad3-95f9025bdb35" alt=""><figcaption></figcaption></figure>

5\) When prompted, enter your password to log back in.

<figure><img src="https://240799936-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LcWdZhwLCll1J0u091B%2Fuploads%2Fb3XfAqciEdBmpKGoyadG%2Fimage.png?alt=media&#x26;token=5c9ddf4a-cfea-4ffc-94ee-d0b8e6ae5c74" alt=""><figcaption></figcaption></figure>

6\) All contents of your environment — including files, virtual environments, and configurations — will remain intact.