Windows Support
aqua >= v1.12.0
The author @suzuki-shunsuke doesn't use Windows, so the help of Windows Users is welcome.
Install
Please see Install.
The separator of AQUA_GLOBAL_CONFIG
- Command Prompt, PowerShell:
;
- Git Bash:
:
Required Standard Registry Version
Please upgrade Standard Registry to v2.28.1 or later.
Windows Settings
aqua works even if Developer Mode
is disabled.
And you don't have to run the terminal as Administrator.
Windows Security
Please change the settings at your own risk.
Security software may prevent aqua from installing and running tools.
In that case, you may have to add AQUA_ROOT_DIR
to security software's exclusion.
Windows Support of installed tools
Note that some tools don't support Windows. aqua skips installing those tools on Windows with supported_if or supported_envs.
tools written in shell scripts aren't supported
Currently, tools written in shell scripts aren't supported.
Windows specific features
Auto complesion of the file extension
Please see complete_windows_ext.
Create BAT files and shell scripts instead of symbolic links and aqua-proxy
#885 #892 #893 aqua >= v1.12.0
Reference (Japanese): https://zenn.dev/link/comments/725555a2b1b034
aqua creates executable BAT files and shell scripts instead of symbolic links.
Why is this change needed?
On Windows, there are two problems regarding symbolic links.
- To create symbolic links, you have to run Terminal (cmd.exe, PowerShell, Git Bash, etc) as Administrator or enable Developer Mode
- PowerShell has a bug about symbolic link https://github.com/PowerShell/PowerShell/issues/16171
Windows ARM Emulation
Please see windows_arm_emulation.
Trouble Shooting
Interactive Search by aqua g
doesn't work on Git Bash
The guide of gh auth login
is helpful.
https://github.com/ktr0731/go-fuzzyfinder/issues/2#issuecomment-1154872091
You appear to be running in MinTTY without pseudo terminal support.
MinTTY is the terminal emulator that comes by default with Git for Windows. It has known issues with gh's ability to prompt a user for input.
There are a few workarounds to make gh work with MinTTY:
- Reinstall Git for Windows, checking "Enable experimental support for pseudo consoles".
Use a different terminal emulator with Git for Windows like Windows Terminal. You can run "C:\Program Files\Git\bin\bash.exe" from any terminal emulator to continue using all of the tooling in Git For Windows without MinTTY.
Prefix invocations of gh with winpty, eg: "winpty gh auth login". NOTE: this can lead to some UI bugs.