Поиск
Справочник

Как установить Laravel на VPS с Ubuntu

Laravel 13 работает на PHP 8.3 и новее — эта версия и ставится из пакетов Ubuntu 24.04. На сервер нужно поставить PHP с модулями, Composer и nginx, загрузить проект, заполнить файл .env и дать сайту права на запись в две папки. Ниже все шаги по порядку, с командами.

≈ 8 мин чтения8 шагов
Содержание 13

Что сделать прямо сейчас

  1. Поставьте PHP с модулями, Composer и nginx — шаги 1 и 2.
  2. Загрузите проект в папку /var/www/example.com — шаг 3.
  3. Установите зависимости, заполните .env, создайте ключ — шаги 4–6.
  4. Дайте права на папки — шаг 7.
  5. Настройте nginx — nginx для Laravel.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Работайте от своего пользователя с правами sudo, не от root. Вместо example.com везде подставьте свой домен.

Что нужно Laravel

Что нужноЧем поставить
PHP 8.3 или новеев Ubuntu 24.04 — пакет php-fpm, он ставит PHP 8.3
модули Ctype, Fileinfo, PDO, Tokenizerвходят в пакет php8.3-common, ставятся вместе с PHP
модули Filter, Hash, OpenSSL, PCRE, Sessionвстроены в сам PHP
модуль cURLпакет php-curl
модули DOM и XMLпакет php-xml
модуль Mbstringпакет php-mbstring
Composer — ставит библиотеки проектапакет composer
веб-серверпакет nginx

Список модулей взят из документации Laravel 13, состав пакетов — с сайта пакетов Ubuntu.

1. Поставьте PHP и модули

sudo apt update
sudo apt install php-fpm php-cli php-mbstring php-xml php-curl php-zip php-mysql php-sqlite3 unzip

Если система спросит пароль, введите пароль своего пользователя — символы при вводе не видны. На вопрос Do you want to continue? [Y/n] нажмите Enter.

ПакетЗачем
php-fpmPHP для сайта — через него nginx запускает Laravel
php-cliPHP для команд в терминале: php artisan, composer
php-zip и unzipComposer распаковывает ими пакеты
php-mysqlподключение к MySQL и MariaDB; для PostgreSQL — php-pgsql
php-sqlite3база SQLite — её новый проект Laravel использует с самого начала

Пакеты с именем php-… ставят модули для той версии PHP, которая есть в вашей Ubuntu: в 24.04 это php8.3-….

Проверьте:

php -v
php -m | grep -iE 'curl|dom|mbstring|pdo'

Первая строка ответа php -v начинается с PHP 8.3. Вторая команда покажет модули curl, dom, mbstring и PDO с драйверами. Подробнее — в статье Установка PHP.

2. Поставьте Composer и nginx

sudo apt install composer nginx
composer --version

В Ubuntu 24.04 из пакетов ставится Composer 2.7.1. Laravel 13 требует Composer 2.2 или новее — этой версии хватает. Подробнее — Установка Composer и Установка nginx.

3. Загрузите проект

Создайте папку сайта и сделайте себя её владельцем:

sudo mkdir -p /var/www/example.com
sudo chown $USER:$USER /var/www/example.com
Откуда проектКоманда
из Git-репозиторияgit clone https://github.com/имя/проект.git /var/www/example.com
новый пустой проектcomposer create-project laravel/laravel /var/www/example.com
с компьютеразагрузите папку целиком, без vendor и node_modules — они ставятся на сервере

Как работает клонирование — в статье git clone. Загрузить папку с компьютера поможет rsync.

Команда composer create-project сама выполняет шаги 4–6: ставит зависимости, создаёт .env и ключ, создаёт базу SQLite и таблицы. После неё переходите к шагу 7, а в .env поправьте строки из шага 5.

4. Установите зависимости

cd /var/www/example.com
composer install --no-dev --optimize-autoloader
КлючЧто делает
--no-devне ставит пакеты для разработки — тесты и отладку
--optimize-autoloaderсоставляет полный список классов, чтобы PHP быстрее их находил

Composer запускайте от своего пользователя, не через sudo — почему.

Если в папке проекта есть файл package.json, соберите стили и скрипты — для этого нужен Node.js:

npm install
npm run build

Без сборки Laravel пишет ошибку Vite manifest not found.

5. Заполните .env

cp .env.example .env
nano .env

Поменяйте строки:

APP_NAME="Мой сайт"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.com

В образце стоят APP_ENV=local и APP_DEBUG=true — так оставлять нельзя: при ошибке посетитель увидит пути к файлам и настройки.

База в образце — SQLite (DB_CONNECTION=sqlite). Для MySQL уберите знак # в начале строк DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD и впишите свои значения, а в DB_CONNECTION — mysql.

Сохраните файл: Ctrl+O, Enter, выход — Ctrl+X (как работать в nano). Все строки .env по порядку — в статье .env на рабочем сайте.

6. Создайте ключ и таблицы

php artisan key:generate
php artisan migrate --force

Первая команда записывает в строку APP_KEY файла .env случайный ключ — им Laravel шифрует cookie и другие данные. Вторая создаёт таблицы в базе. Ключ --force нужен на рабочем сайте: без него Laravel с APP_ENV=production переспросит, точно ли выполнять. Подробнее — Миграции на рабочем сайте.

7. Дайте права на storage и bootstrap/cache

Laravel пишет в две папки: storage — журнал, кеш, загруженные файлы — и bootstrap/cache. Сайт работает от пользователя www-data, поэтому отдайте папки ему:

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R ug+rwX storage bootstrap/cache
sudo usermod -aG www-data $USER

Третья команда добавляет вас в группу www-data — тогда Composer сможет записывать в bootstrap/cache при обновлениях. Группа начнёт действовать после нового входа: отключитесь и подключитесь по SSH заново.

Соберите кеш настроек от пользователя сайта:

cd /var/www/example.com
sudo -u www-data php artisan optimize

Что делает команда — в статье php artisan optimize.

8. Настройте nginx и проверьте

Настройки сайта для nginx — в статье nginx для Laravel. После неё проверьте:

curl -I http://example.com/up

В первой строке ответа должен быть код 200. Адрес /up есть в каждом новом проекте Laravel: он отвечает 200, если Laravel запустился без ошибок. Подробнее — Как проверить проект Laravel.

Затем подключите HTTPS — бесплатный SSL-сертификат.

Ошибки и как их исправить

Что видитеПричинаЧто делать
Composer пишет, что нужен php ^8.3на сервере PHP старше 8.3Разбор
Composer пишет ext-… is missing from your systemне поставлен модуль PHPРазбор
Composer просит zip или unzipнет php-zip или unzipРазбор
could not find driverнет модуля PHP для базыРазбор
No application encryption key has been specified.не выполнен key:generateРазбор
Please provide a valid cache path.нет папок или прав в storageРазбор
Vite manifest not foundне собраны стили и скриптыРазбор
страница 500 Server Errorошибка записана в журналРазбор
502 Bad Gatewaynginx не достучался до PHP-FPMРазбор

Все ошибки Laravel по тексту сообщения — на странице Ошибки Laravel.

Источники

Сверено 13 ноября 2026 года.

Где попробовать. Команды из статьи безопаснее сначала повторить на отдельном тестовом сервере, а не на рабочем. Подойдёт VPS с Ubuntu, например Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше