Установка последней версии PhpStorm в WSL без боли и костылей
📏 Проблема
При работе с PhpStorm внутри WSL через JetBrains Gateway оказывается, что даже при наличии новой версии IDE на хостмашине (например, 2025.1.2
), в WSL запускается устаревшая (2024.3.1 RC
), загруженная Gateway автоматически. Это приводит к несовместимости с плагинами (Laravel Idea, AI Assistant), ограниченной функциональности и проблемам с отладкой.
Решение — установить актуальную GUI-версию PhpStorm напрямую в WSL через Toolbox App, без Gateway.
📀 Что потребуется
WSL2 + WSLg (Windows 11);
Ubuntu или другой Linux внутри WSL;
Терминал и доступ в интернет.
🛠 Шаг 1. Получение ссылки на актуальную версию Toolbox
Скачивать Toolbox App лучше через официальный API JetBrains:
wget -O toolbox.json "https://data.services.jetbrains.com/products/releases?code=TBA&latest=true&type=release"
Затем извлекается поле linux.link
:
cat toolbox.json | grep -oP '"linux":\s*"\K[^"]+'
Если установлен jq
, стандартный вариант:
jq -r '.TBA[0].downloads.linux.link' toolbox.json
Пример ссылки:
https://download.jetbrains.com/toolbox/jetbrains-toolbox-2.6.3.43718.tar.gz
Скачиваем и распаковываем:
wget https://download.jetbrains.com/toolbox/jetbrains-toolbox-2.6.3.43718.tar.gz
tar -xzf jetbrains-toolbox-2.6.3.43718.tar.gz
cd jetbrains-toolbox-2.6.3.43718
🧰 Шаг 2. Установка зависимостей
sudo apt update
sudo apt install -y libfuse2 libxi6 libxrender1 libxtst6 libfontconfig libgtk-3-bin
🚀 Шаг 3. Установка PhpStorm через Toolbox
./jetbrains-toolbox &
После запуска Toolbox открывается графическое окно. Из списка IDE выбирается PhpStorm и устанавливается актуальная версия в WSL.

🔗 Шаг 4. Alias для запуска
Сначала нужно найти phpstorm.sh
:
find ~ -type f -name phpstorm.sh 2>/dev/null
Пример пути:
~/.local/share/JetBrains/Toolbox/apps/phpstorm/bin/phpstorm.sh
Добавление alias:
echo 'alias phpstorm="$HOME/.local/share/JetBrains/Toolbox/apps/phpstorm/bin/phpstorm.sh"' >> ~/.bashrc
source ~/.bashrc
Теперь PhpStorm запускается командой:
phpstorm &
📎 Шаг 5. Ярлык для Windows
В ярлыке на рабочем столе Windows достаточно указать:
wsl.exe -d Ubuntu -- bash -ic "phpstorm"
Ключ -ic
обеспечивает загрузку .bashrc
, без него alias не будет работать.
✅ Результат
Установлена PhpStorm
2025.1.2
напрямую внутри WSL;Совместимость с плагинами и современным стеком;
Запуск IDE как из Linux-терминала, так и из ярлыка Windows;
Нет зависимости от Gateway.
📌 Вывод
Стандартный JetBrains Gateway удобен, но не даёт контроля над версией IDE. Установка Toolbox и последней PhpStorm внутри WSL устраняет это ограничение, позволяет использовать актуальные плагины, улучшает стабильность и избавляет от проблем совместимости. Решение хорошо подходит для ежедневной разработки и легко масштабируется на другие продукты JetBrains.