Installing Bash on Microsoft Windows
This page provides instructions for installing a Bash shell on Microsoft Windows, required for running the Caplin Deployment Framework on Windows.
The Caplin Deployment Framework is compatible with the Bash shells Cygwin and Git Bash.
|Microsoft Windows is not a supported operating system for production deployments of Caplin Platform components.|
To install Cygwin, follow the steps below:
Download the Cygwin installer from the Cygwin website.
Run the Cygwin installer and follow the installation instructions on the Cygwin website.
When prompted by the installer, select the following additional packages: zip, unzip, vim, vim-common, dos2unix, wget, and curl.
After installation, open a Cygwin terminal and run the command below to configure Cygwin to implement Bash symbolic links as Windows file shortcuts:
echo 'export CYGWIN=winsymlinks:lnk' >> ~/.bashrc
Alternatively, if you don’t want to set
~/.bashrc, then you can set it temporarily when unzipping the Deployment Framework:
$ CYGWIN=winsymlinks:lnk unzip -qoa DeploymentFramework-<version>.zip
Close the Cygwin terminal
For background information on how Cygwin implements Bash symbolic links on Windows, see Symbolic links in the Cygwin manual.
Installing Git Bash
Git Bash is included with Git for Windows. If you already have Git for Windows installed, skip to step 3 in the installation instructions below.
The Git for Windows installer requires you to have a knowledge of common Git configuration options. In case you are not familiar with Git, the instructions below include a list of Git options commonly used by Windows developers in mixed-OS environments. If you have already installed Git for Windows, you do not need to adjust your Git configuration to suit the example options below.
To install Git for Windows, follow the steps below:
Git requires a default editor, and Notepad++ is a better option on Windows than the traditional Git default of Vim if you need to integrate Git with other Windows programs. See the Choosing the default editor used by Git option below.
Run the Git for Windows installer, and select the following Git configuration options when prompted:
Choosing the default editor used by Git: Use Notepad++
Notepad++ is a better choice than Vim if you need to integrate Git with other Windows programs.
Adjusting your PATH environment: 'Use Git from the Windows Command Prompt'
Choosing the SSH executable: 'Use OpenSSH'
Choosing HTTPS transport backend: 'Use the OpenSSL library'
Configuring the line ending conventions: 'Checkout as-is, commit Unix-style line endings'
Configuring the terminal emulator: 'Use MinTTY'
Configuring extra options: 'Enable file system caching' and 'Enable Git Credential Manager'
The extra option 'Enable symbolic links' is not required by the Caplin Platform on Windows. This option configures the
gitcommand on Windows to implement Bash symbolic links as NTFS native symbolic links. This option requires Windows 10, local Administrator privileges, and a new group policy entry (
After installation, open a Git Bash terminal and run the command below to configure Git Bash to implement Bash symbolic links as Windows file shortcuts:
echo 'export MSYS=winsymlinks:lnk' >> ~/.bashrc
The next time you open a Git Bash terminal, Git Bash will warn you that it has automatically created a Bash
~/bash_profilefile. You can safely ignore this warning.
If you don’t want to set
~/.bashrc(for example, if you’ve set
MSYS=winsymlinks:nativestrictfor working with Git), then you can set
MSYS=winksymlinks:lnktemporarily when unzipping the Deployment Framework:
$ MSYS=winsymlinks:lnk unzip -qoa DeploymentFramework-<version>.zip
Close the Git Bash terminal