[Somente PaaS]{class="badge informative" title="Aplica-se somente a projetos do Adobe Commerce na nuvem (infraestrutura do PaaS gerenciada pela Adobe) e a projetos locais."}

Instalação de início rápido local

As instruções nesta página descrevem como instalar o Adobe Commerce na infraestrutura auto-hospedada. Para obter orientação sobre como atualizar uma instalação existente, consulte o Guia de Atualização.

O Adobe usa o Composer para gerenciar componentes do Adobe Commerce e suas dependências. Usar o Composer para obter o metapackage do Adobe Commerce oferece as seguintes vantagens:

Pré-requisitos

Antes de continuar, faça o seguinte:

Efetuar login como proprietário do sistema de arquivos

Saiba mais sobre propriedade, permissões e o proprietário do sistema de arquivos no tópico Visão geral de propriedade e permissões.

Para alternar para o proprietário do sistema de arquivos:

Obter o metapackage

Para obter o metappackage do Adobe Commerce:

Exemplo - Versão secundária

As versões secundárias contêm novos recursos, correções de qualidade e correções de segurança. Use o Composer para especificar uma versão secundária. Por exemplo, para especificar o metappackage do Adobe Commerce 2.4.6:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

Exemplo - Correção de qualidade

Os patches de qualidade contêm principalmente correções de segurança e funcionais. No entanto, às vezes elas também podem conter recursos novos e compatíveis com versões anteriores. Use o Composer para baixar um patch de qualidade. Por exemplo, para especificar o metappackage do Adobe Commerce 2.4.6:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6 <install-directory-name>

Exemplo - Correção de segurança

Os patches de segurança contêm apenas correções de segurança. Elas foram projetadas para tornar o processo de atualização mais rápido e fácil.

Os patches de segurança usam a convenção de nomenclatura do Composer 2.4.6-px. Use o Composer para especificar um patch. Por exemplo, para baixar o metappackage 2.4.6-p1 do Adobe Commerce:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>

Definir permissões de arquivo

Você deve definir permissões de leitura e gravação para o grupo de servidores Web antes de instalar o Adobe Commerce. Isso é necessário para que a linha de comando possa gravar arquivos no sistema de arquivos.

cd /var/www/html/<magento install directory>
find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
chown -R :www-data . # Ubuntu
chmod u+x bin/magento

Instalar o aplicativo

Você deve usar a linha de comando para instalar o Adobe Commerce.

Este exemplo supõe que o diretório de instalação seja nomeado como magento2ee, o db-host esteja na mesma máquina (localhost) e que o db-name, db-user e db-password sejam todos magento:

bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15

Resumo do comando

Para exibir uma lista completa de comandos, insira:

bin/magento list

Para obter ajuda para um comando específico, insira:

bin/magento help <command>

Por exemplo:

bin/magento help setup:install

bin/magento help cache:enable

A tabela a seguir resume os comandos disponíveis. Os comandos são exibidos somente na forma de resumo. Para obter mais informações sobre um comando, clique no link na coluna Comando.

Argumentos comuns

Os argumentos a seguir são comuns a todos os comandos. Esses comandos podem ser executados antes ou depois que o aplicativo for instalado: