Windows Support

Documentation for getting aws-okta working with Windows.

Environments where aws-okta works under Windows basically fall into 2 categories: Native Windows and Windows Subsystem for Linux (WSL). Note that your home directory in WSL and your home directory in Native Windows are not the same! Changes you make in WSL will not be reflected outside of WSL and vice versa.

Native Windows

Native Windows includes Windows shells/environments that execute Windows binaries and use the standard Windows filesystems available in Explorer. aws-okta generally works fine here but aws-okta add must be run in cmd.exe or PowerShell (not ISE) and network drives are known to cause problems with Go. Environments where aws-okta login and aws-okta exec are known to work include:

cmd.exe
PowerShell
PowerShell ISE
Git BASH

Installation

Install go for windows >= 1.10
If you're using network drives on your system make sure that %GOPATH% and %GOROOT% point to a LOCAL disk. You may also need to download the zip distribution of golang and manually install on a local drive.
Install gcc. MinGW-w64 package is known to have issues while Win-builds 1.5.0 has been confirmed working.
From your favorite shell go get github.com/segmentio/aws-okta
Add %USERPROFILE%\go\bin to your PATH
From a cmd.exe shell run aws-okta add - some shells lack the required functionality for this command to work but cmd.exe is consistent
Follow the general instructions for configuring and using aws-okta
To update go get -u github.com/segmentio/aws-okta

Windows Subsystem for Linux

aws-okta generally works fine in WSL as long as you're on Windows build >= 15093. Windows builds earlier than this lack the console features required. To find out what build of Windows you're on run the winver command.

The easiest way to install under WSL is to download the latest release Linux binary and put it somewhere in your path.

Installation From Source

Install golang >= 1.10 - follow the instructions here if your WSL distribution does not natively include an appropriate version
go get github.com/segmentio/aws-okta
Add ~/go/bin to your $PATH
Follow the general instructions for configuring and using aws-okta
To update go get -u github.com/segmentio/aws-okta

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!