---
title: Creating Bookmarks to a Windows or Citrix Terminal Server
slug: ps/help/en_us/ics/end-user/en/creating-bookmarks-to-a-windows-or-citrix-terminal-server
createdAt: 2026-08-23T07:06:42.885Z
---

If your administrator enables personal terminal services bookmarks, you can create your own bookmarks to your company’s terminal server as well as the applications that are installed on the terminal server.

To create a bookmark to a Windows or Citrix terminal server:

1. On the secure gateway home page, click the **Add a Terminal Session** icon on the title bar for the Terminal Sessions panel.
2. Select the type of terminal server (**Windows Terminal Services** or **Citrix**) from the Session Type list.
3. Enter a name and (optionally) a description for the bookmark.
4. In the Host field, specify the hostname or IP address of the terminal server.
5. In the Client Port and Server Port fields, enter port numbers for the terminal server.
6. If you want to specify how the terminal emulation window should appear during your terminal session, use configuration options in the Settings section of the bookmark configuration page.
7. If you want to pass your username and password from the secure gateway to the terminal server so you can sign onto the terminal server without having to manually enter your credentials, use configuration options in the Session section of the bookmark configuration page.
8. If you only want to use this bookmark to access specific applications on the terminal server, use configuration options in the Start Application section of the bookmark configuration page.
9. If you want to access local resources such as printers and drives through the terminal session, use configuration options in the Connect Devices section of the bookmark configuration page.
10. Click **Add**.

### Defining Display Options

When configuring a terminal services bookmark, you can specify how the terminal emulation window should appear during a terminal session:

1. Create a terminal services bookmark or edit an existing bookmark using the instructions above.
2. Scroll to the Settings section of the bookmark configuration page.
3. From the Screen Size list, specify how large you want to make the terminal server window. (By default, the secure gateway sets the window size to full screen.)

:::hint{type="info"}
- Windows Terminal Services only) If you select the **Full Screen** option and are connecting to a Windows terminal server, the secure gateway needs to modify your hosts file in order to display the correct host name in the terminal services window. If you do not have the proper rights to modify the hosts file, the secure gateway displays the loopback address instead.
- Also note that in order to restore the hosts file to its original state after running the terminal services window, you must properly close your application. Otherwise, other applications that use the hosts file (such as JSAM and Host Checker) might not run properly. You can also restore your hosts file to its original state by rebooting your system or by renaming the backup hosts file (hosts\_ive.bak).
:::

4. From the Color Depth list, specify the number of colors you want to display in the terminal server window. (By default, the secure gateway sets the color depth to 8-bit.)
5. (Windows Terminal Services only) Select **Desktop background** if you want to display a wallpaper background during the terminal session. If you do not select this option, the background is blank.
6. (Windows Terminal Services only) Select **Show contents of window while dragging** if you want to show the contents of the Windows Explorer window while you move windows on your desktop.
7. (Windows Terminal Services only) Select **Menu and window animation** if you want to animate the movement of windows, menus, and lists.
8. (Windows Terminal Services only) Select **Themes** if you want to be able to set Windows themes in your terminal server windows.
9. (Windows Terminal Services only) Select **Bitmap Caching** if you want to improve performance by minimizing the amount of display information that is passed over a connection.
10. (Windows Terminal Services only) Select **Font Smoothing (RDP 6.0 onwards**) to make text smoother and easier to read.
11. (Windows Terminal Services only) Select **Desktop Composition (RDP 6.0 onwards)** to allow desktop composition. With desktop composition, individual windows no longer draw directly to the screen. Instead, their drawing is redirected to video memory, which is then rendered into a desktop image and presented on the display.

### Defining Single Sign-on Options

When configuring a terminal services bookmark, you can configure the secure gateway to pass your username and password from the secure gateway to the terminal server so that you do not have to manually enter your credentials. The secure gateway passes the specified credentials when you click the session bookmark. If the credentials fail, the server prompts you to manually enter your username and password.

To define single sign-on options:

1. Create a terminal services bookmark or edit an existing bookmark using the instructions above.
2. Scroll to the Authentication section of the bookmark configuration page.
3. Enter your username and password (optional). Note that you cannot enter variables in the **Username** and **Password** fields. The secure gateway only accepts static credentials.
4. (Citrix only) Select **Use domain credentials** to pass your cached domain credentials to the Citrix Metaframe server (also called pass-through authentication).

:::hint{type="info"}
- If you select the **Use domain credentials** option, you must also enable pass-through authentication through your settings file (appsrv.ini). If you have already successfully signed into the Metaframe server using cached domain credentials, this setting should already be enabled. Otherwise, you must:
- Set EnableSSOnThruICAFile=On in appsrv.ini. You can locate appsrv.ini in the %HOMEPATH%\Application Data\ICAClient directory.
- Set UseLocalUserAndPassword=On in the ICA file.
- If pass-through authentication is not enabled through the INI file, you will be prompted to manually enter your credentials when your try to access the Metaframe server through the secure gateway.
:::

### Defining Application Settings

When configuring a terminal services bookmark, you can specify individual applications to access on the terminal server:

1. Create a terminal services bookmark or edit an existing bookmark using the instructions above.
2. Scroll to the Start Application section of the bookmark configuration page.
3. In the Path to application field, specify where the application’s executable file resides on the terminal server. For example, you might enter the following directory for the Microsoft Word application:

```bash
C:\Program Files\Microsoft Office\Office10\WinWord.exe
```

4. In the Working directory field, specify where the terminal server should place working files for the application. For example, you might specify that Microsoft Word should save files to the following directory by default:

```bash
C:\Documents and Settings\<username>\My Documents
```

:::hint{type="info"}
You can use secure gateway session variables such as \<username> and \<password> in the Path to application and Working directory fields. For example, when specifying an application path, you might want to include the \<username> variable to personalize the location. For example: C:\Documents and Settings\\\<username>\My Documents
:::

### Defining Device Connections

When configuring a terminal services bookmark, you can specify local resources that are accessible through the terminal session:

1. Create a terminal services bookmark or edit an existing bookmark using the instructions above.
2. Scroll to the Connect Devices section of the bookmark configuration page.
3. Select **Connect local drives** if you want to connects your local drive to the terminal server, enabling you to copy information from the terminal server to your local client directories.
4. Select **Connect local printers** if you want to connect your local printers to the terminal server, enabling you to print information from the terminal server to your local printer.
5. Select **Connect COM Ports** if you want to connect your COM ports to the terminal server, allowing communication between the terminal server and the devices on your serial ports.
6. Select **Allow Clipboard Sharing** if you want to allow the contents of the clipboard to be shared between the your host computer and the terminal server. If you are using an RDP client version prior to 6.0 and select all options except Allow Clipboard Sharing, then all devices are disabled. Select all options, including Allow Clipboard Sharing, to enable all devices

:::hint{type="info"}
- If your system administrator does not enable the Connect local drives, Connect local printers, Connect COM ports, or Allow clipboard sharing options for your user role, you cannot see these options in your secure gateway terminal session.
- When you enable local resources using these options, you are the only user who may access the resources from the terminal server. For instance, another user cannot see your local directories.
:::
