개발을 하다 보면 우분투의 초기 세팅을 하는 일이 잦다.
따라서 내가 우분투를 설치하고 나서 가장 먼저 세팅하는 것들을 위주로 소개하고자 한다.
꾸준히 업데이트 예정.

현재 업데이트 버전:
ununtu:22.04, mac: m3 pro sonoma 14.4
2025-09-14 업데이트: pyenv 설정 추가
2025-09-22 업데이트: git ssh config 삭제, make 및 c++ 설정 삭제
2025-10-16 업데이트: .zshrc 서버 이름 추가

1. command

1-1. git global config

git config --global core.editor "cursor --wait"
git config --global user.name "ji-hyup"
git config --global user.email "newnyup@gmail.com"
git config --global push.autoSetupRemote true

1-2. (optional) git https로 진입

gh auth login

1-3. (optional) docker login

• ghcr 이용하기 위함

docker login ghcr.io -u rimgosu

2. docker 설치

• https://docs.docker.com/engine/install/ubuntu/

sudo apt-get update
sudo apt-get install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

• sudo 없이 사용

sudo usermod -aG docker $USER
newgrp docker

3. zsh 설치

• oh-my-zsh

sudo apt-get update
sudo apt-get install -y zsh curl git
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

• plugins

git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

vi ~/.zshrc
plugins=(git zsh-autosuggestions zsh-syntax-highlighting)
source ~/.zshrc

• 추가적으로 하면 좋은 것:

echo 'export LC_ALL=ko_KR.UTF-8' >> ~/.zshrc
cat >> ~/.zshrc << 'EOF'
PROMPT='%n@ '$PROMPT
EOF
source ~/.zshrc

4. nvm 설치

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

.zshrc 설정 파일 변경

• vi ~/.zshrc

autoload -U add-zsh-hook
load-nvmrc() {
  local nvmrc_path=".nvmrc"

  # '.nvmrc' 파일이 현재 디렉토리에 있는지 확인
  if [[ -f "$nvmrc_path" ]]; then
    nvm use
  elif [[ $commands[nvm] ]]; then
    # '.nvmrc' 파일이 없다면 기본 버전을 사용
    nvm use default
  fi
}

# 디렉토리가 변경될 때마다 'load-nvmrc' 함수를 실행
add-zsh-hook chpwd load-nvmrc
load-nvmrc

• source ~/.zshrc

pnpm, yarn 설치

npm install -g pnpm
npm install -g yarn

5. mac 추가 설정

brew 설치

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
vi ~/.zshrc

:
:
eval "$(/opt/homebrew/bin/brew shellenv)"
:
:

source ~/.zshrc

mac vscode path 설정

mac vscode 설치 -> vscode path 설정

# VS Code
export PATH="$PATH:/Applications/Visual Studio Code.app/Contents/Resources/app/bin"

mac 유틸리티

mac 자판 설정

한성 키보드(bt5.0) 기준

1. karabiner-element 설치 https://karabiner-elements.pqrs.org/
2. 한영키, fn키 매핑 https://blog.naver.com/paintshop5/222996072682
   2-1. application -> fn
   2-2. right_option -> f18
   2-3. 맥 설정 - 키보드 - 키보드 단축키 - 입력 소스 - 입력 메뉴에서 다음 소스 선택 - f18
3. CapsLock 키 딜레이 줄이기 https://itbluebook.tistory.com/3
   3-1. 맥 설정 - 키보드 - 입력 소스 편집 - CapsLock 키로 ABC 입력 소스 전환 비활성화

데스크탑 및 Dock 설정

핫 코너

맥 설정 - 데스크탑 및 Dock - 핫 코너... - Mission Control 설정

자동으로 Dock 가리기와 보기

맥 설정 - 데스크탑 및 Dock - 자동으로 Dock 가리기와 보기

화면 가르기 설정

brew install --cask rectangle

6. pyenv

필수 패키지 설치

sudo apt update
sudo apt install -y build-essential libssl-dev zlib1g-dev \
                    libbz2-dev libreadline-dev libsqlite3-dev \
                    libncurses5-dev libncursesw5-dev xz-utils tk-dev \
                    libffi-dev liblzma-dev python3-openssl git

pyenv 설치

curl https://pyenv.run | bash
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(pyenv init --path)"' >> ~/.zshrc
echo 'eval "$(pyenv init -)"' >> ~/.zshrc
source ~/.zshrc