라라벨 3 - 맥북 라라벨 개발 환경 구축: Sail & Homestead 설치 가이드 메모

이 글에서는 맥북에서 라라벨 개발을 시작하기 위해 필요한 환경 구축 방법을 정리 함

Laravel Sail과 Homestead를 설치하고, Docker 및 Vagrant 기반 개발 환경을 세팅하는 과정을 단계별 메모했다.

공부한 내용을 요약해줘 라고 지피티에게 부탁하고 수정한 내용이여서 부족한 내용이 있을 수 있음

내가 볼 수 있을 정도의 메모용도이기에 너무 맹신하지 말고 직접 확인 꼭 하길 바람!

 

1. 라라벨 Sail을 이용한 환경 구축

• 도커 다운로드
  • Linux (Ubuntu):

    sudo apt update && sudo apt upgrade -y
    curl -fsSL https://get.docker.com | sh
    sudo systemctl enable docker
    sudo systemctl start docker
    sudo usermod -aG docker $USER

  • Windows (PowerShell, 관리자 권한):

    dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
    dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
    wsl --set-default-version 2
    Start-Process "https://www.docker.com/products/docker-desktop/"

• 라라벨 Sail 다운로드
  • 공통 (Linux / macOS / WSL):

    curl -s "https://laravel.build/sample" | bash
    cd sample
    ./vendor/bin/sail up -d

• 라라벨 Sail 종료 및 실행 방법
  • 앨리어스 등록:

    alias sail="./vendor/bin/sail"

  • 컨테이너 실행:

    sail up

  • 백그라운드 실행:

    sail up -d

  • 컨테이너 종료:

    sail down

  • 컨테이너 접속:

    sail shell

  • MySQL 접속:

    sail mysql

2. Homestead을 이용한 환경 구축

• 기본 설치
  • Git 설치:

    sudo apt install git -y

  • VirtualBox 설치: 공식 사이트
  • Vagrant 설치: 공식 사이트
• Homestead.yaml 초기화 및 설정
  • Mac 기준 설치 경로(보통 하드디스크>사용자>맥북사용자이름>Homestead): ~/Homestead
  • Homestead 초기화:

    bash init.sh   # Linux/Mac
    init.bat         # Windows

  • Homestead.yaml 수정
    • 1. 프로바이더 설정:

      ip: "192.168.56.56"
      memory: 2048
      cpus: 2
      provider: virtualbox

    • 2. 공유 디렉터리 설정:

      folders:
        - map: ~/code
          to: /home/vagrant/code

    • 3. 사이트 설정:

      sites:
        - map: homestead.test
          to: /Users/yd/Documents/laravel/laravel_docker/sample
      
      databases:
        - homestead

• Homestead 실행 및 접속
  • VM 실행:

    vagrant up

  • SSH 접속(ssh 접속의 경우에 Cheak your Homestead.yaml ... 같은 내용이 나타난다면 개인키 공개키를 먼저 생성해야 합니다) :

    vagrant ssh

  • VM 종료:

    vagrant halt

  • VM 재부팅:

    vagrant reload

  • VM 삭제:

    vagrant destroy

  • VM 상태 확인:

    vvagrant status

 

$ vagrant up

Check your Homestead.yaml (or Homestead.json) file, the path to your private key does not exist.

SSH 접속을 위한 개인키 공개키 설정 방법
2025.09.15 - [분류 전체보기] - 라라벨 3 - 맥북 라라벨 개발 환경 구축: Sail & Homestead 설치 가이드 메모

라라벨 3 - 맥북 라라벨 개발 환경 구축: Sail & Homestead 설치 가이드 메모

Homestead.yaml 

---
# 내컴퓨터>사용자>사용자명>Homestead
ip: "192.168.56.56"     # 사용하는 운영체제에 따라 달라질 수 있음
memory: 2048
cpus: 2
provider: virtualbox    # 1. 프로바이더 설정.  ## VM을 VirtualBox로 실행하겠다는 의미

authorize: ~/.ssh/id_rsa.pub   # VM에 로그인할 수 있도록 공개 키 지정

keys:                         # 실제 개인 키(private key) 경로 지정
  - ~/.ssh/id_rsa

folders:                # 2. 공유 디렉터리 설정
  - map: ~/code
    to: /home/vagrant/code

sites:                  # 3. 사이트 설정
  - map: homestead.test
    to: /Users/yd/Documents/laravel/laravel_docker/sample     # /home/vagrant/code/public

databases:
  - homestead

features:
  - mariadb: false
  - postgresql: false
  - ohmyzsh: false
  - webdriver: false

services:
  - enabled:
      - "mysql"
#   - disabled:
#       - "postgresql@11-main"

# ports:
#   - send: 33060 # MySQL/MariaDB
#     to: 3306
#   - send: 4040
#     to: 4040
#   - send: 54320 # PostgreSQL
#     to: 5432
#   - send: 8025 # Mailpit
#     to: 8025
#   - send: 9600
#     to: 9600
#   - send: 27017
#     to: 27017