Skip to main content

Using CAG on MacOS

The following is a quick start guide to access CAG.

Using Your PIV Card

Getting started.

  1. If possible, make sure you are using the latest version of MacOS, 10.15 (Catalina). To check the version of MacOS click the Apple icon on the top left of your screen, then choose “About This Mac”.
    information screen showing the latest version of the operating system from Apple
  2. Download and install Citrix Workspace. This was recently updated and now supports MacOS 10.13-10.15.4.
    Software downloads with the MocOS installer highlighted
  3. These instructions will work for Chrome and Edge for Mac. Safari can work, but is problematic and should be avoided. Firefox does not work.
  4. Insert your PIV card into the reader
  5. If you’ve inserted your PIV, accept the prompt to add certs (you’ll need to enter your MacOS password to install these certs to your MacOS Keychain).
  6. Access the VA Citrix Access Gateway - (Make sure to bookmark so you can get back to it easily for future connections to CAG.)
  7. If you have a PIV, select the first option, “Smartcard.” If you do not, choose the username and password option, enter your username and password, then skip to step 9.
  8. IMPORTANT: In most cases, if using Chrome or Edge, you will need to select the second certificate from the list when prompted.This is not 100% of the time, so if you get an error you may need to close your browser, reopen and then select the first certificate.
    certificate selection in Chrome and Edge
  9. If prompted, select “Open Citrix Workspace Launcher,” then check the box “I agree with the Citrix license agreement,”
  10. Once the CAG Storefront appears, navigate to the “Desktop” tab at the top and choose a desktop. Learn about the new CAG Desktop Options
  11. 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.
  12. Give Citrix permissions on the Mac if prompted.
  13. Once the desktop opens, if you are not using PIV (PIV exempt), enter your username and password.
  14. If you are using PIV, wait for the option for “Sign-in options” to populate under the username and 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
  15. You’re in! You can access all your regular applications and conduct your normal work.
  16. 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.
    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 and it automatically taking you to an error page or you experience other errors, like this:
  3. Login
    1. Select the PIV icon and enter your PIN
    2. Chrome and Edge - use the second certificate in the list 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 and 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 sign out when you’re done. 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

Page last updated on May 7, 2020


An official website of the U.S. Department of Veterans Affairs

Looking for U.S. government information and services?

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