Files
linux-odyssey/docs/windows-setup.md
T

2.5 KiB

Windows Environment Setup

Prerequisites

  1. Have a computer with Windows 10 or later.
  2. Install WSL and Ubuntu on Windows.
  3. Enter Ubuntu terminal.

Setup Environment (In Ubuntu terminal)

  1. Update and upgrade

    $ sudo apt-get update
    $ sudo apt-get upgrade
    
  2. Install Git

    $ sudo apt-get install git
    
  3. Install Node.js (Version 20.x)

    $ curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
    $ sudo apt-get install nodejs
    
  4. Install Docker

  5. Install Python 2.7

Run the Project (In Ubuntu terminal)

  1. Installation

    $ git clone https://github.com/lancatlin/linux-odyssey.git
    $ cd linux-odyssey
    $ yarn install
    
  2. Docker setup

    $ docker compose pull
    $ docker compose build
    $ docker-compose up -d
    
  3. Run the project

    $ yarn build
    $ yarn dev
    

References

Install Docker

(Refer to get.docker.com)

To install the latest stable versions of Docker CLI, Docker Engine, and their dependencies:

  1. Download the script

    $ curl -fsSL https://get.docker.com -o install-docker.sh
    
  2. verify the script's content

    $ cat install-docker.sh
    
  3. run the script with --dry-run to verify the steps it executes

    $ sh install-docker.sh --dry-run
    
  4. run the script either as root, or using sudo to perform the installation.

    $ sudo sh install-docker.sh
    
  5. Verify the installation

    $ docker --version
    

Install Python 2.7

  1. Install required packages

    $ sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncurses-dev xz-utils tk-dev libffi-dev liblzma-dev python3-openssl git
    
  2. Install pyenv

    $ curl https://pyenv.run | bash
    
  3. Add following lines to bash configuration file (e.g. ~/.bashrc, ~/.bash_profile, ~/.zshrc)

    export PATH="$HOME/.pyenv/bin:$PATH"
    eval "$(pyenv init --path)"
    eval "$(pyenv init -)"
    eval "$(pyenv virtualenv-init -)"
    
  4. Restart the shell

  5. Install Python 2.7.18 using pyenv

    $ pyenv install 2.7.18
    
  6. Set Python 2.7.18 as the global version

    $ pyenv global 2.7.18
    
  7. Verify the installation

    $ python --version