Note: Please read the below instructions carefully to extract the best result from this repo.

Initial Workstation Config

Table of Contents

• What is this about?
• Pre-requisites
• Getting Ready
• How to Setup?
  • VIM Aliases
  • TMux Aliases
• Contributing
• References
  • Linux OS

What is this about?

This is a Git repository to help you setup your new workstation for commonly used tools and make changes to them as you move ahead, using the power of Git & GitHub.

The current steps cover some well known OSes used for development and have been tested on

1. Mac OS X (Monterey: 12.3.1)
2. Ubuntu (Focal Fossa: 20.04 LTS)
3. CentOS 7 (7.5-1804)
4. Fedora Workstation 28 but it should work seamlessly on any variants lower or higher than the above.

Pre-Requisites

1. A computer with Linux OS like Ubuntu, Fedora, CentOS or UNIX OS like Mac OS X or Windows.
2. Depending on the above, a shell like Bash, Zsh on Linux/UNIX based OS or PowerShell on Windows
3. A text editor like Vim to modify the files from this repo (We will install IDE such as VSCode and terminal applications iTerm2 or Tabby shortly after).
4. SSH | GPG Keys
5. Git and access to this GitHub repo
6. Based on your OS, a package manager such as apt-get, yum for Linux OS, brew for Mac OS X or chocolatey for Windows.
7. Tmux

Getting Ready

As per your OS (Mac / Linux / Windows), its associated shell and terminal:

1. Obtaining VIM is as easy as mentioned in this website
2. You can generate SSH keys and similarly create GPG keys.
3. Please follow these steps to install Git.
4. Then, add SSH keys and GPG keys to Github
5. For Package Manager installation, follow these steps
   • Linux → apt-get or yum
   • Mac OS X → brew
   • Windows → choco
6. Finally, Tmux can be installed via this document.

How to Setup?

1. From the native terminal app of your OS,
   • Linux → Install Terminal via apt-get install gnome-terminal
   • Mac OS X → Install iTerm2 via brew install iterm2
   • Windows → Install Tabby via choco install tabby
2. Then on the respective terminals, clone this repo locally using git clone git@github.com:vinayhegde1990/initial-workstation-config.git
3. Change your directory to the downloaded repo cd initial-workstation-config
4. Copy all the files from the aliases directory, .bash_profile, .bashrc in the downloaded git repo to your home directory.
5. Run the source ~/.bash_profile && source ~/.bashrc to get the Bash aliases in effect.
6. Alternatively, you can also close all Shell sessions and restart them to achieve the same.

Using Vim Aliases

1. Copy .vimrc from downloaded repo to $HOME & ensure .vim folder (with all files) exists there as well.
2. If you already have a VIM process running, you can go into Escape mode by pressing Esc, type : and then write source:~/.vimrc
3. For a new VIM session, the changes will automatically apply themselves.

Using Tmux Aliases

1. Copy all the files from the .tmux/ in the downloaded git repo to your home directory.
2. If you already have a Tmux process running, you can go into Escape mode by pressing Esc, type : and then write source-file :~/.tmux/tmux.conf
3. For a new Tmux session, the changes will automatically apply themselves.

References

Cheers to respective maintainers of cited resources that helped in creating this repo.