CAG – Using Windows

The following is a quick-start guide to accessing CAG using a Windows®-based computer.

a woman sitting on a couch looking at a tablet

Using Your PIV Card

  1. Before you get started, make sure your Windows machine has all patches and hotfixes applied.
  2. These instructions will work the same for Chrome, the new Edge, or Internet Explorer. Edge Legacy will work but can be problematic, and Firefox does not work. Internet Explorer will open Citrix automatically, but other browsers will download an ica file that you will need to click to open (see step 9).
  3. Go to VA Citrix Access Gateway – https://citrixaccess.va.gov. (Make sure to bookmark so you can get back to it easily for future connections to CAG. See: things to be aware of)
  4. If you have a PIV card, insert your PIV card into the reader. If you do not, choose the username and password option, and enter your username and password.
  5. Login
    main screen of the citrix access website giving the user an option to use personal identification card, a token, or username and password
  6. First time users, install VA CAG Client
    Software downloads with windows installer highlighted
    • Follow the prompts
  7. Storefront will appear
    Citrix storefront with options to choose various desktops
  8. Choose a desktop or application from the storefront.
  9. For browsers other than Internet Explorer an *.ica file will download once you select an option and will show in the bottom-left of your browser. Click that download to open this file.
  10. Once the desktop opens, if you are not using PIV (PIV exempt), enter your username and password.
  11. If you are you using PIV, wait for the “Sign-in options” to populate under the username password box. Depending on your screen resolution you may have to scroll a little to see this and this could take a few seconds to show up (be patient). Once you see “Sign-in options,” choose that and select the PIV card icon and enter your PIV PIN when prompted.
    animation showing the desktop interface and the sign in options
  12. You’re in! Work, do good things, then sign off the desktop like a normal Windows machine. Close your browser.
    animation showing disconnecting from CAG

Subsequent connections

  1. Go to VA Citrix Access Gateway (if you created a bookmark in the earlier instructions, then just use that. If you haven’t done that, create a bookmark now!)
  2. See: Things to be aware of if you experience problems re-opening Chrome or the new Edge and it automatically taking you to an error page or you experience other errors, like this:
  3. Login – Select the PIV icon and enter your PIN
  4. Choose the appropriate desktop you want to connect to.
  5. Download and open *.ica file
  6. Once the Windows logon screen launches, wait for the username/password screen to give you the “sign on options” prompt. Click that, choose the PIV icon, then enter your PIV PIN.
  7. You’re in! Work, do good things, then when you’re done, sign out of the desktop like a normal Windows machine by clicking the Windows start button, click the “user icon”, and then choosing Sign out. Close your browser.

Things to be aware of:

  • Chrome and Edge may attempt to open the last site you went to based on the browser settings. To prevent this issue, please change this setting to open a New Tab page (preferred) or a specific page when you open a new browser window. If you continue to experience login issues, make sure you exit completely out of your browser (on Macs, click the Apple icon on MacOS’s toolbar at the top, then choose “force quit,” select your internet browser from the list, then click “force quit.” If you don’t see your browser in that list, you’ve already exited completely, so you can choose “cancel.”)
Chrome settings
US Department of Veterans Affairs

Your feedback matters

Is this website or content helpful? Please let us know. This is anonymous and not stored. Please do not provide personal information — it will not be acted upon. Use Ask VA for questions related to services and benefits. If you or someone you know is in crisis, do not use this form, but connect with the Veterans Crisis Line — Call 988 and press 1 or visit VeteransCrisisLine.net.

We’re here anytime, day or night - 24/7

If you are a Veteran in crisis or concerned about one, connect with our caring, qualified responders for confidential help. Many of them are Veterans themselves.

Get more resources at VeteransCrisisLine.net.