Access RAWeb resources as a workspace - kimmknight/raweb GitHub Wiki

In addition to accessing resources from the RAWeb web interface, you can also access resources via:

  • RemoteApp and Desktop Connections (RADC) on Windows
  • Workspaces in Windows App (formerly Microsoft Remote Desktop) on macOS, Android, iOS, and iPadOS

Important

This feature will only work if RAWeb is using an SSL certificate that is trusted on every device that attempts to access the resources in RAWeb.
Refer to Trusting the RAWeb server for more details and instructions for using a trusted SSL certificate.
We recommend using a certificate from a globally trusted certificate authority.

Identify your workspace URL or email address

Before you can add RAWeb's resources to RADC or Windows App, you need to know the URL for the workspace. Follow these instructions for finding your workspace URL.

  1. Navigate to your RAWeb installation's web interface from the device with RADC or Windows App. This step is important; If you cannot access the web interface from the device with RADC or Windows App, your workspace URL will not work.
  2. Sign in to RAWeb.
  3. Navigate to RAWeb settings.
    • For most users, access settings by clicking or tapping Settings in the bottom-left corner of the screen.
    • If you or your administrator have configured RAWeb to use simple mode, click or tap the settings icon next to you username in the top-right area of the titlebar.
  4. In the Workspace URL section, click or tap Copy workspace URL or Copy email address. Use this URL or email address when adding a workspace.

Now, jump to one of the follow sections based on which device you are using:

Note

Windows App on Windows does not support adding workspaces via URL or email address.
Instead, use RemoteApp and Desktop Connections.

Windows via RemoteApp and Desktop Connections

  1. Right click the Start menu (or press the Windows key + X) and choose Run.
  2. In the Run dialog, type control.exe. Click OK. Control Panel will open.
  3. If needed, change the view from Category to Small icons or Large icons.
  4. Click RemoteApp and Desktop Connections in the list.
  5. On the left side, click Access RemoteApp and desktops.
  6. In the Access RemoteApp and desktops window, enter the workspace URL or email address. Click Next to continue to the next step.
  7. Review the information. Then, click Next to connect.
  8. You will see an Adding connection resources message. During this step, resources and icons are downloaded from RAWeb. Depending on the number of resources, this may take a while.
    • If you see a Windows Security dialog with the message Your credentials did not work, enter the credentials you use to sign in to the RAWeb web interface.

  9. If the connection succeeded, you will see a message indicating the connection name and URL and the programs and desktops that have been added to the Start menu.
    Windows will periodically update the connection. You may also manually force the connection to update via the control panel.

macOS via Windows App

  1. Install Windows App from the App Store.
  2. Open Windows App.
  3. In the menu bar, choose Connections > Add Workspace....
  4. In the Add Workspace sheet, enter the workspace URL or email address. Change Credentials to the credentials you use when you sign in to the RAWeb web interface. Click Add to add the workspace.
  5. You will see a Setting up workspace... message. During this step, resources and icons are downloaded from RAWeb. Depending on the number of resources, this may take a while.

If the connection succeeeded, you will see your apps and devices included in Windows App.

Android via Windows App

  1. Install Windows App from the Play Store.
  2. Open Windows App.
  3. Tap the + button in the top-right corner of the app.
  4. Choose Workspace.
  5. In the Add Workspace dialog, enter the workspace URL or email address. Change User account to the credentials you use when you sign in to the RAWeb web interface. Tap Next to add the workspace.
  6. You will see a Setting up workspace... message. During this step, resources and icons are downloaded from RAWeb. Depending on the number of resources, this may take a while.

iOS and iPadOS via Windows App

  1. Install Windows App Mobile from the App Store.
  2. Open Windows App.
  3. Tap the + button in the top-right corner of the app.
  4. Choose Workspace.
  5. In the Add Workspace sheet, enter the workspace URL or email address. Change Credentials to the credentials you use when you sign in to the RAWeb web interface. Tap Next to add the workspace.
  6. You will see a Setting up workspace... message. During this step, resources and icons are downloaded from RAWeb. Depending on the number of resources, this may take a while.
⚠️ **GitHub.com Fallback** ⚠️