Linux Mint (Cinnamon / XFCE) 上で PHP/Laravel + Python + JavaScript/TypeScript の開発環境をワンコマンドで構築するスクリプト集です。

新しい PC に Linux Mint を入れた直後の真っ新な状態から、bootstrap.sh 1 つで 日本語入力・開発ランタイム・モダンなターミナル・主要 IDE まで揃います。

• OS: Linux Mint 22.x (Cinnamon / XFCE)、ベースは Ubuntu 24.04 (Noble)
• CPU: Intel x86_64 (ARM 未対応)
• RAM: 推奨 8GB 以上 (4GB でも動作はします)
• キーボード: 日本語 (JIS) 配列推奨

Ubuntu 24.04 系であれば Linux Mint 以外の派生でもおおむね動くはずですが、 xdg-open の挙動や Cinnamon 固有の設定 (NumLock 等) は Mint を前提にしています。

PHP には Xdebug / Redis / Imagick の各拡張も自動でインストールされます (install-runtimes.sh php 実行時)。

• Node.js / Python / PHP の本体: install-runtimes.sh で別途インストール
• JetBrains 系 IDE (PhpStorm 等): 必要なら手動で
• MySQL / PostgreSQL / Redis 等の DB: Docker での運用を推奨
• Adobe 系・MS Office 系: Linux 版を別途インストールするか Web 版を使用

Linux Mint をインストールした直後の状態を想定しています。 Git すら入っていない状態から始めるので、まず Git と curl をインストールします。

sudo apt update && sudo apt install -y git curl

# このリポジトリをそのまま使う場合
git clone https://github.com/digila/linux-mint-setup.git ~/linux-mint-setup

# 自分用にカスタマイズしたい場合は GitHub で Fork してから
git clone https://github.com/YOUR_USERNAME/linux-mint-setup.git ~/linux-mint-setup

cd ~/linux-mint-setup

(自分でフォークして使う場合は YOUR_USERNAME を自分のユーザー名に置き換えてください)

./bootstrap.sh

確認プロンプトに y で答えると、4 つのスクリプトが順に実行されます (約 30〜60 分):

1. システム基本 (日本語入力・NumLock・Chrome)
2. 開発ランタイム (Git・fnm・pyenv・phpenv・Composer・Claude Code)
3. ターミナル環境 (WezTerm・Starship・PlemolJP・モダン CLI)
4. GUI アプリ (Docker・VS Code・Antigravity・GitKraken・Slack・gh)

完了後、必要に応じて以下の補助スクリプトを実行します:

./scripts/install-runtimes.sh latest          # Node.js / Python / PHP の最新版
./scripts/antigravity-extensions.sh install   # Antigravity 拡張機能を一括導入
./scripts/fix-intel-gpu-electron-apps.sh      # Intel HD Graphics 環境のフリーズ対策 (該当機のみ)
./scripts/optimize-boot.sh                    # 起動時間の短縮 (任意)

# Git のユーザー設定 (まだなら)
git config --global user.name  "あなたの名前"
git config --global user.email "[email protected]"

# 再起動 (Docker / NumLock / 日本語入力を完全有効化)
sudo reboot

再起動後、各アプリの初回ログイン:

• gh: ターミナルで gh auth login → ブラウザで GitHub に認証
• Antigravity: メニューから起動 → 個人 Gmail でログイン
• GitKraken: メニューから起動 → GitHub と連携
• Slack: メニューから起動 → ワークスペースに参加
• Claude Code: ターミナルで cd プロジェクト && claude

• 日本語入力 (fcitx5 + mozc, Mac 風キーバインド = かな ON / 英数 OFF)
• NumLock 起動時 ON (LightDM + systemd の二重設定で確実)
• Google Chrome + デフォルトブラウザ設定

• Git (日本語ファイル名対応, 既定設定)
• fnm (Node.js のバージョン管理, .nvmrc 自動切替)
• pyenv (Python のバージョン管理, .python-version)
• phpenv + php-build (PHP のバージョン管理, .php-version)
• Composer
• Claude Code (ネイティブインストーラ)
• PHP ビルド依存関係 (libicu, libzip, libonig, libsodium ほか)

• WezTerm (タブ + ペイン + cwd 通知)
• Starship (PHP/Node/Python のバージョンを自動表示)
• PlemolJP フォント (全バリエーション)
• モダン CLI: ripgrep, fd, bat, eza, fzf, jq, yq, lazygit, direnv, mkcert
• bash エイリアス + OSC 7 (ペイン分割で同じ cwd で開く)

• Docker Engine + Compose
• VS Code (公式 APT)
• Google Antigravity (AI IDE)
• GitKraken
• Slack (Flatpak)
• GitHub CLI (gh) (公式 APT)
• Mailpit (Laravel メールテスト)
• Flameshot (スクリーンショット)

02-dev-runtime.sh で各ツール (fnm/pyenv/phpenv) は入れていますが、 Node.js/Python/PHP 本体は別途インストールします。

# 各ランタイムの最新版を一括
./scripts/install-runtimes.sh latest

# 個別:
./scripts/install-runtimes.sh node latest
./scripts/install-runtimes.sh node 22 20
./scripts/install-runtimes.sh python latest
./scripts/install-runtimes.sh python 3.13.0
./scripts/install-runtimes.sh php latest
./scripts/install-runtimes.sh php 8.2 8.3 8.4   # 複数バージョン (Xdebug+Redis+Imagick 自動)

⚠️ Python は pyenv global を変更しません。 詳細は下の pyenv の使い方 を参照。

# 現在の拡張機能をファイル化
./scripts/antigravity-extensions.sh export

# ファイルから一括インストール (別 PC で使う)
./scripts/antigravity-extensions.sh install

# 現在の拡張機能を変更後、Git 差分を表示
./scripts/antigravity-extensions.sh sync

# インストール済み一覧 (バージョン付き)
./scripts/antigravity-extensions.sh list

拡張機能リストは dotfiles/antigravity-extensions.txt に保存され、Git 管理対象です。

Intel HD Graphics 530/520/620 等の Skylake/Kaby Lake 世代の Intel GPU で、 Electron 系アプリ (Antigravity, VS Code, Chrome, Slack) が拡張機能インストール 時等に PC 全体をフリーズさせる既知の問題対策。

# 各 Electron アプリの GPU 加速を一括無効化
./scripts/fix-intel-gpu-electron-apps.sh

# それでもフリーズが続く場合は カーネルパラメータも修正
./scripts/fix-intel-gpu-electron-apps.sh full
sudo reboot

新しい GPU を搭載した PC (NVIDIA / AMD / 第 8 世代以降の Intel) では不要です。

./scripts/optimize-boot.sh

NetworkManager-wait-online の無効化、GRUB タイムアウト短縮、Cinnamon 設定 デーモンの無駄起動抑制などで 約 8〜10 秒短縮 できます。

linux-mint-setup/
├── bootstrap.sh                          # メインエントリ
├── README.md                             # このファイル
├── .gitignore
├── docs/
│   └── USAGE.md                          # WezTerm/Starship 等の使い方早見
├── dotfiles/                             # シンボリックリンクされる設定ファイル
│   ├── wezterm.lua                       # WezTerm 設定
│   ├── starship.toml                     # Starship 設定
│   └── antigravity-extensions.txt        # Antigravity 拡張機能リスト
└── scripts/
    ├── 01-system.sh                      # システム基本
    ├── 02-dev-runtime.sh                 # 開発ランタイム
    ├── 03-terminal.sh                    # ターミナル
    ├── 04-apps.sh                        # GUI アプリ
    ├── install-runtimes.sh               # ランタイム個別インストール
    ├── antigravity-extensions.sh         # Antigravity 拡張機能管理
    ├── fix-intel-gpu-electron-apps.sh    # Intel GPU 対策
    ├── optimize-boot.sh                  # 起動時間最適化
    └── lib/
        └── common.sh                     # 共通ヘルパー関数

dotfiles/ 配下のファイルは、ホームディレクトリの設定ファイルパスへ シンボリックリンク されます。

~/.config/wezterm/wezterm.lua  →  ~/linux-mint-setup/dotfiles/wezterm.lua
~/.config/starship.toml        →  ~/linux-mint-setup/dotfiles/starship.toml

これにより:

• リポジトリ側のファイルを編集すると 即座にターミナル動作に反映
• 自分でフォークして使えば、git commit & git push で別 PC に設定を同期できる
• 設定変更の履歴が git log で追える

antigravity-extensions.txt は通常ファイル(リンクではなく)で管理しています。 更新は ./scripts/antigravity-extensions.sh export で行います。

bootstrap.sh には引数で個別実行モードがあります:

./bootstrap.sh system      # 01-system.sh のみ
./bootstrap.sh dev         # 02-dev-runtime.sh のみ
./bootstrap.sh terminal    # 03-terminal.sh のみ
./bootstrap.sh apps        # 04-apps.sh のみ

各スクリプトは冪等(再実行しても壊れない)に作ってあるので、 追加で何か入れたいときに何度でも回せます。

このリポジトリは「動く参考実装」です。自分用に変えたい場合は フォーク して使ってください:

# 1. GitHub でこのリポジトリを Fork
# 2. 自分のフォーク先からクローン
git clone https://github.com/YOUR_USERNAME/linux-mint-setup.git ~/linux-mint-setup
cd ~/linux-mint-setup

# 3. dotfiles を編集して push
vim dotfiles/wezterm.lua
git add -A
git commit -m "Customize WezTerm"
git push

# 4. 別 PC では git pull するだけで反映

複数 PC を運用する人は、自分用フォークを 1 つ作っておくと開発環境を完全に同期できます。

Intel HD Graphics 530/520/620 等の Skylake/Kaby Lake 世代の Intel GPU で、 Electron 系アプリが拡張機能インストール時等に PC 全体をフリーズさせる場合:

./scripts/fix-intel-gpu-electron-apps.sh
# それでも続くなら
./scripts/fix-intel-gpu-electron-apps.sh full
sudo reboot

ImportError: ... undefined symbol: PyExc_NotImplementedError

このエラーが出る場合は pyenv が悪さしています:

pyenv global system          # システム Python に戻す
sudo reboot                   # または cinnamon --replace で復旧

各スクリプトは冪等です。失敗箇所を直して再実行すれば、成功した部分はスキップされます。

# apt が中途半端な状態の場合 (前回のフリーズ後など)
sudo dpkg --configure -a
sudo apt install -f

# 再実行
./bootstrap.sh

一度ログアウト → ログインしてください。それでも効かない場合は再起動。

ネットワーク接続を確認してください。Docker Hub や GitHub に接続できる必要があります。

ビルド依存パッケージが不足している可能性があります:

sudo apt install -y build-essential libssl-dev libicu-dev libzip-dev \
                    libonig-dev libxml2-dev libcurl4-openssl-dev libsodium-dev \
                    libmagickwand-dev

docker グループへの追加は 再ログインで反映 されます:

sudo reboot

Linux Mint は内部でシステムの Python (/usr/bin/python3) を使って Cinnamon デスクトップや Nemo (ファイラー) を動かしています。

pyenv global 3.x.x で別バージョンに切り替えると、システムが期待する PyGObject などの Python モジュールが見つからなくなり、Cinnamon が起動 しなくなります (デスクトップが真っ黒になる症状)。

# ❌ NG: システムが壊れる
pyenv global 3.13.0

# ✅ OK: プロジェクト単位で切り替え
cd ~/projects/my-app
pyenv local 3.13.0          # .python-version が作られる
python3 --version           # → 3.13.0 (このフォルダだけ)

# システム全体は system のまま維持
pyenv global system

ターミナルから:

pyenv global system
cinnamon --replace > /tmp/cinnamon.log 2>&1 &
disown

install-runtimes.sh は pyenv global を変更しない設計なので、 このスクリプト経由でインストールすればこの問題は起きません。

このスクリプト集を作る過程で発見した、Linux Mint × pyenv × Electron の組み合わせで起こる地雷とその対策を共有します:

同じ環境で困っている人の参考になれば幸いです。

MIT License

このセットアップは Claude (Anthropic) との対話を通じて作成されました。 何度もシステムを破壊しながら、最終的に Linux Mint 開発環境構築の知見が 詰まったスクリプト集になりました。