Tutoriais

https://vvcestudio.com.br/pt/tutorial/php/drupal/
menu

Drupal - Instalação local no Ubuntu

Para iniciar a instalação precisa garantir que algumas coisas já estejão instaladass e rodando no seu Linux.

Checagem pré-requisitos
x
$ docker --version
//docker --version
$ lando version
// v3.25.6
$ composer --version
Composer version 2.9.5 2026-01-29 11:40:53
PHP version 8.3.30 (/usr/bin/php8.3)
$ php -v
// PHP 8.3.30

Matar todos os processos apagar o diretório

Parar processos deste projeto:
$ lando stop
$ lando destroy -y
Para todos os processo com lando deste computador:
$ lando poweroff
Apagar processos fantasmas:
$ docker volume prune -f
Apagar diretorio.
$ cd ..
$ rm -rf /drupallandolinux

Criar o diretório e entrar nele
x
$ mkdir drupallandolinux
$ cd drupallandolinux
Instalar Drupal e Drush via host (PHP 8.3)
x
$ composer create-project drupal/recommended-project:^10 .
$ composer require drush/drush
Inicialização do Lando
x
$ lando init \
--source cwd \
--recipe drupal10 \
--webroot web \
--name drupallandolinux

Edite o .lando.yml para garantir o PHP correto:

.lando.yml
x
$ nano .lando.yml
name: drupallandolinux
recipe: drupal10
config:
php: '8.3'
webroot: web
database: mariadb:10.6

Provisionamento do Ambiente:

shell
x
$ lando start

Instalação e configura o banco de dados (sem interface web):

shell
x
$ lando drush site:install --db-url=mysql://drupal:drupal@database:3306/drupal --account-name=admin --account-pass=admin -y

Se não funcionar use explicitamente o caminho do drush e o comando do PHP.

shell
x
$ lando php /app/vendor/bin/drush site:install --db-url=mysql://drupal:drupal@database:3306/drupal --account-name=admin --account-pass=admin -y -vvv

Verificação:

URL: https://drupallandolinux.lndo.site
Login: admin / password: admin
Drush: lando drush status
PHP 8.3

Dar permissões de escrita na pasta

(Necessário no Linux)
Libere para o Lando gerenciar as configurações:

shell
x
$ chmod -R 777 web/sites/default

Gerar link de acesso direto

Para entrar no painel administrativo sem digitar a senha (uli: significa user-login):

shell
x
$ lando drush uli
Ou
$ lando drush uli --uri=https://drupallandolinux.lndo.site --root=/app/web

Copie o link e abra no navegador.

Se algo der errado:

Tentativa simples

shell
x
$ lando rebuild -y
$ composer install

Matar tudo e iniciar tudo novamente

Parar processos deste projeto:
shell
x
$ lando stop
$ lando destroy -y

Para todos os processo com lando deste computador

shell
x
$ lando poweroff
Apagar processos perdidos fantasmas:
shell
x
$ docker volume prune -f
Recriar o arquivo de configuração
shell
x
$ lando drush site:install --db-url=mysql://drupal:drupal@database:3306/drupal --account-name=admin --account-pass=admin -y --root=/app/web

Testes basicos

1º Verifique se os containers estão rodando:
shell
x
$ lando list
// service: database, appserver e proxy 2º Teste de Conexão Direta:
shell
x
$ lando mysql
// Se não retorna nada (nem erro, nem o prompt do banco), significa que o processo do cliente MySQL dentro do container está travando ou não consegue se comunicar com o processo do servidor MariaDB. Verificar a conexão com o banco
shell
x
$ lando ssh -s database -c "mysqladmin -u mariadb -pmariadb ping"
// Retorna “mysqld is alive” se ok.

Entrar no contreiner

Entrar no contreiner
x
$ lando ssh -s database --user root
Dentro do container, execute este comando para resetar o usuário mariadb:
Resetar usuário mariadb
x
$ mysql -u root -e "CREATE USER IF NOT EXISTS 'mariadb'@'%' IDENTIFIED BY 'mariadb'; GRANT ALL PRIVILEGES ON *.* TO 'mariadb'@'%' WITH GRANT OPTION; FLUSH PRIVILEGES;"
# Saia do container
$ exit

Rebuild do projeto

shell
x
$ lando rebuild -y

Reconfigurar o banco

shell
x
$ lando drush site:install --db-url=mysql://mariadb:mariadb@database/mariadb --account-name=admin --account-pass=admin -y --root=/app/web

Criar URL de acesso

shell
x
lando drush uli --uri=https://drupallandolinux.lndo.site --root=/app/web
Copia o link e abra no navegador.

Comandos uteis:

Verificar o Status:

para ver se está tudo "Connected" (Banco, Config, PHP) $ lando drush status

Limpar o Cache:

Útil após instalações $ lando drush cr

Exportar Configurações:

$ lando drush cex -y para salvar o estado atual do site no disco. https://drupallandolinux.lndo.site/c

Local:

User: admin
Senha: admin