Pesquisa de site

Como instalar o NEOS CMS no servidor Ubuntu 24.04

Este tutorial existe para estas versões do sistema operacional

  • Ubuntu 24.04 (Nobre Numbat)
  • Ubuntu 22.04 (Jammy Medusa)
  • Ubuntu 20.04 (FocalFossa)
  • Ubuntu 18.04 (castor biônico)

Nesta página

  1. Pré-requisitos
  2. Instalando Dependências
  3. Configurando PHP
  4. Configurando o servidor MariaDB
  5. Baixando o código-fonte do Neos CMS
  6. Configurando o host virtual Apache
  7. Protegendo Neos CMS com HTTPS
  8. Instalando NEOS CMS a partir da linha de comando
  9. Conclusão

Neos é um sistema de gerenciamento de conteúdo gratuito e de código aberto com edição intuitiva, internacionalização completa, flexibilidade máxima e facilidade de integração com sistemas de terceiros.

Neos é um gerenciamento de conteúdo empresarial integrado com modelagem de conteúdo personalizada que fornece uma maneira eficaz de editar e gerenciar conteúdo, otimização de SEO, como redirecionamentos automáticos e metadados de SEO, e funções poderosas e gerenciamento de usuários.

Neste guia, orientaremos você na instalação do Neos CMS no servidor Ubuntu 24.04. Você instalará o Neos CMS com LAMP Stack, Composer e ImageMagick. Você utilizará o utilitário flow para instalar e gerenciar o Neos CMS.

Pré-requisitos

Para começar com este guia, certifique-se de ter:

  • Um servidor Ubuntu 24.04.
  • Um usuário não root com privilégios de administrador.
  • Um nome de domínio apontado para o endereço IP do seu servidor.

Instalando Dependências

Antes de instalar o Neos CMS, você precisa instalar dependências como LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP), Composer, Git e ImageMagick. Esses pacotes estão disponíveis por padrão no repositório Ubuntu e você pode instalá-los através do APT.

Primeiro, atualize o índice do seu pacote Ubuntu com o seguinte comando:

atualização sudo apt

Agora instale as dependências do Neos CMS com o comando abaixo. A seguir, você instalará os pacotes LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP), Composer, Git e ImageMagick.

sudo apt instalar apache2 mariadb-server compositor git php php-cli php-common php-imap php-redis php-snmp php-xml php-zip php-imagick php-mbstring php-curl libapache2-mod-php php-mysql imagemagick

Insira Y para confirmar a instalação.

Após a instalação, verifique o status dos serviços Apache e MariaDB para garantir que estejam em execução.

Verifique o servidor web Apache com o seguinte. Você verá que o serviço está ativado e ativo (em execução).

sudo systemctl está habilitado apache2
sudo systemctl status apache2

Agora verifique o status do serviço MariaDB com o seguinte – Você verá uma saída semelhante. O MariaDB está habilitado e ativo (em execução).

sudo systemctl está habilitado mariadb
sudo systemctl status mariadb

Por último, verifique as versões do PHP e do Composer usando o comando abaixo. PP 8.3 e Composer 2.7 estão instalados em seu sistema Ubuntu.

php -v
sudo -u www-data compositor -v

Configurando PHP

Após instalar as dependências, você configurará a instalação do PHP editando o arquivo php.ini e reiniciando o servidor web Apache.

Abra o arquivo de configuração do PHP /etc/php/8.3/apache2/php.ini com o seguinte comando do editor nano.

sudo nano /etc/php/8.3/apache2/php.ini

Altere a configuração padrão com o seguinte. Certifique-se de ajustar date.timezone e memory_limit com as configurações do seu servidor.

date.timezone = Europe/Amsterdam
upload_max_filesize = 80M
memory_limit = 512M
max_execution_time = 360

Ao terminar, salve o arquivo e saia do editor.

Agora execute o comando abaixo para reiniciar o servidor web Apache e aplicar sua configuração PHP.

sudo systemctl reiniciar apache2

Configurando o servidor MariaDB

Nesta seção, você protegerá a instalação do servidor MariaDB e criará um novo banco de dados e usuário para Neos CMS. Você utilizará o mariadb-secure-installation para proteger o MariaDB e, em seguida, acessará o servidor MariaDB por meio do cliente mariadb.

Para proteger a instalação do servidor MariaDB, execute o comando mariadb-secure-installation abaixo.

sudo mariadb-instalação segura

Agora você será solicitado com as configurações do servidor MariaDB:

  • Para a instalação padrão do servidor MariaDB sem senha root, pressione ENTER quando questionado sobre a senha.
  • A autenticação local para usuários root do MariaDB é protegida por padrão, insira ‘n’ quando solicitado a alterar o método de autenticação para ‘unix_socket’.
  • Insira 'Y' para criar uma nova senha root do MariaDB. Em seguida, insira a senha forte do usuário root do MariaDB e repita.
  • Quando solicitado a desabilitar a autenticação remota para o usuário root do MariaDB, insira 'Y' para concordar.
  • A instalação padrão do servidor MariaDB vem com o banco de dados ‘teste’ e permite que um usuário anônimo o acesse.
  • Insira 'Y' para ambas as configurações para remover o banco de dados padrão 'test' e remover o privilégio anônimo.
  • Por último, insira 'Y' para confirmar o recarregamento dos privilégios da tabela.

Depois de proteger o MariaDB, você criará um novo banco de dados e usuário por meio do utilitário cliente mariadb.

Execute o comando abaixo para fazer login no servidor MariaDB. Digite sua senha root do MariaDB quando solicitado.

sudo mariadb -u raiz -p

Agora execute as seguintes consultas para criar um novo banco de dados e usuário para Neos CMS. Neste exemplo, você criará um novo banco de dados neosdb, um usuário neos com a senha neospassword. Você pode ajustar essas informações com as suas.

CRIAR BANCO DE DADOS neosdb;
CRIAR USUÁRIO neos@localhost IDENTIFICADO POR ‘neospassword’;
CONCEDER TODOS OS PRIVILÉGIOS NO neosdb.* PARA neos@localhost IDENTIFICADO POR ‘neospassword’;
PRIVILÉGIOS FLUSH;

A seguir, execute a consulta abaixo para verificar os privilégios do usuário neos. Certifique-se de que o usuário neos possa acessar o banco de dados neosdb.

MOSTRAR BOLSAS PARA neos@localhost;

Por último, digite quit para sair do servidor MariaDB.

Baixando o código-fonte do Neos CMS

Agora que configurou o PHP e o MariaDB, você fará o download do código-fonte do Neos CMS e instalará as dependências do PHP com o Composer. Você também configurará a instalação do Neos CMS com permissão e propriedade adequadas.

Primeiro, execute o comando git abaixo para baixar o código-fonte do Neos CMS para o diretório /var/www/neos.

clone do git https://github.com/neos/neos-base-distribution.git /var/www/neos

Vá para o diretório /var/www/neos e instale as dependências do Neos CMS com o comando composer abaixo.

cd /var/www/neos
instalação do compositor

Por enquanto, digite yes para confirmar e executar o Composer como root.

Após a conclusão do processo, execute o comando abaixo para alterar a permissão do código-fonte do Neos CMS para o usuário www-data.

sudo ./flow core:setfilepermissions www-data www-data
sudo chown -R www-data:www-data /var/www/neos

Configurando o host virtual Apache

Nesta seção, você criará um novo host virtual Apache para executar o Neos CMS. Portanto, certifique-se de ter seu nome de domínio apontado para o endereço IP do servidor. Você pode usar o domínio público ou o domínio local para desenvolvimento.

Habilite os módulos rewrite e ssl para Apache com o comando abaixo.

sudo a2enmod reescrever SSL

Agora crie um novo arquivo de host virtual Apache /etc/apache2/sites-available/neos.conf com o seguinte editor nano.

sudo nano /etc/apache2/sites-available/neos.conf

Insira a configuração no arquivo e insira seu nome de domínio na opção ServerName.

<VirtualHost *:80>
 ServerName howtoforge.local
 ServerAdmin [email 
 ErrorLog ${APACHE_LOG_DIR}/howtoforge.local.error.log
 CustomLog ${APACHE_LOG_DIR}/howtoforge.local.access.log combined
 #SetEnv FLOW_CONTEXT Production
 DocumentRoot /var/www/neos/Web
 # Add security
 php_flag register_globals off
 <Directory /var/www/neos/Web>
 AllowOverride All
 </Directory>
 <Directory /var/www/neos/Web/>
 RewriteEngine on
 RewriteBase /
 RewriteCond %{REQUEST_FILENAME} !-f
 RewriteRule ^(.*) index.php [PT,L]
 </Directory>
 </VirtualHost>

Quando terminar, salve e saia do arquivo.

Em seguida, execute o comando abaixo para ativar o arquivo host virtual neos.conf e verifique a sintaxe do Apache. Se você tiver a sintaxe correta e adequada do Apache, obterá uma saída Syntax is OK.

sudo a2ensite neos.conf
sudo apachectl configtest

Por último, execute o seguinte para reiniciar o servidor web Apache e aplicar suas alterações. Depois de reiniciado, seu Neos CMS deverá estar pronto.

sudo systemctl reiniciar apache2

Protegendo Neos CMS com HTTPS

Neste guia, você executará Neos CMS com HTTPS por meio de Certbot e Letsencrypt. Isso só é possível se você estiver instalando o Neos CMS no nome de domínio público. Se estiver usando um domínio local, você pode gerar certificados SSL com OpenSSL e configurar HTTPS manualmente.

Instale o plugin Certbot e Certbot Apache com o seguinte comando. Digite Y para confirmar a instalação.

sudo apt instalar certbot python3-certbot-apache2

Agora execute o comando certbot abaixo para gerar certificados SSL/TLS para Neos CMS. Certifique-se de alterar o endereço de e-mail e o nome de domínio com suas informações.

sudo certbot --apache --agree-tos --redirect --hsts --staple-ocsp --email [email protegido] -d howtoforge.local

Após a conclusão do processo, seus certificados SSL estarão disponíveis no diretório /etc/letsencrypt/live/domain.com. E seu Neos CMS deve ser protegido automaticamente com HTTPS.

Instalando NEOS CMS a partir da linha de comando

Agora que você baixou o código-fonte do Neos CMS e configurou o host virtual Apache, você iniciará a instalação do Neos CMS através do terminal. Com o utilitário flow, você pode gerenciar e instalar o Neos CMS a partir do seu terminal.

Vá para o diretório /var/www/neos com o seguinte:

cd /var/www/neos

Execute o comando abaixo para configurar um banco de dados para Neos CMS. Selecione mysqli como driver de banco de dados e insira seus detalhes do banco de dados MariaDB e do usuário que você criou.

sudo ./flow setup:banco de dados

Quando for bem-sucedido, você verá uma saída como Database neosdb was conectado com sucesso.

Agora execute o comando abaixo para configurar o manipulador de imagens padrão para Neos CMS e selecione Imagick.

sudo ./flow setup:imagehandler

Após configurar o banco de dados e o manipulador de imagens, execute o comando abaixo para migrar o banco de dados Neos CMS.

sudo ./flow doutrina:migrar

Você pode ver a seguinte saída durante a migração do banco de dados.

Em seguida, execute o seguinte para criar um usuário administrador para a instalação do Neos CMS. Digite seu nome de usuário, endereço de e-mail, nome, sobrenome e sua senha.

sudo ./flow usuário:create --roles administrador

Você obterá uma saída como a seguinte:

Agora execute o comando abaixo para importar o site Neos.Demo para sua instalação. se for bem-sucedido, você obterá uma saída Importação do site "Neos Demo site" concluída.

sudo flow:cache:flush
sudo ./flow site:import --package-key Neos.Demo

Com isso, o Neos CMS está completo. Visite seu nome de domínio, como https://howtoforge.local, e você obterá a página inicial do Neos CMS como a seguinte:

Para acessar a página de login do Neos CMS, visite https://howtoforge.local/login e insira seu usuário administrador e senha que você criou. Clique em Login para confirmar.

Se você tiver credenciais de administrador adequadas, verá o painel do Neos CMS como o seguinte:

Conclusão

Parabéns! Você concluiu a instalação do Neos CMS em um servidor Ubuntu 24.04. Você tem Neos CMS rodando com LAMP Stack (Linux, Apache, MySQL/MariaDB e PHP) e protegido com HTTPS por meio do Let's Encrypt. Você também aprendeu o comando básico flow para instalar e gerenciar o Neos CMS.