Instalação CMS · 10 min read · Nov 22, 2025

Como Instalar o Neos CMS no Ubuntu 22.04

Neos CMS é um sistema de gerenciamento de conteúdo gratuito, de código aberto e inovador que ajuda você a gerenciar sites e blogs sem nenhum conhecimento de programação. É simples, seguro e projetado para facilidade de uso, o que ajuda os proprietários de negócios a colaborar com usuários em vários dispositivos. Oferece recursos muito úteis, incluindo suporte completo a Unicode, internacionalização completa, SEO, edição inline e muito mais. A ideia central por trás do projeto é permitir que editores editem conteúdo da forma mais fluida possível, mantendo sua estrutura.

Neste tutorial, mostraremos como instalar o Neos CMS com Apache e SSL Let’s Encrypt no servidor Ubuntu 22.04.

Pré-requisitos

  • Um servidor rodando Ubuntu 22.04.
  • Um nome de domínio válido apontado para o IP do seu servidor.
  • Uma senha de root configurada no servidor.

Começando

Primeiro, execute os seguintes comandos para atualizar todos os pacotes do seu sistema para as versões mais recentes:

apt update -y  
apt upgrade -y

Uma vez que você tenha terminado, pode prosseguir para o próximo passo.

Instalar Apache, MariaDB e PHP

Em seguida, você precisará instalar o Apache, MariaDB, PHP e outros pacotes necessários no seu sistema. Execute o seguinte comando para instalar todos eles:

apt-get install apache2 mariadb-server php libapache2-mod-php php-common php-mysql php-gmp php-curl php-intl php-mbstring php-xmlrpc php-gd php-bcmath php-xml php-cli php-gmagick php-zip curl unzip git -y

Após instalar todos os pacotes, edite o arquivo php.ini e faça algumas alterações:

nano /etc/php/8.1/apache2/php.ini

Altere as seguintes linhas:

short_open_tag = On
memory_limit = 256M
upload_max_filesize = 150M
max_execution_time = 360
date.timezone = UTC

Salve e feche o arquivo, então reinicie o serviço Apache para aplicar as alterações:

systemctl restart apache2

Criar um Banco de Dados para o Neos CMS

Primeiro, você precisará definir uma senha de root do MariaDB e proteger a instalação. Você pode fazer isso usando o seguinte comando:

mysql_secure_installation

Responda a todas as perguntas como mostrado abaixo:

Enter current password for root (enter for none):
Set root password? [Y/n]: N
Remove anonymous users? [Y/n]: Y
Disallow root login remotely? [Y/n]: Y
Remove test database and access to it? [Y/n]:  Y
Reload privilege tables now? [Y/n]:  Y

Uma vez que você tenha terminado, faça login no MariaDB com o seguinte comando:

mysql -u root -p

Uma vez logado, crie um banco de dados e um usuário para o Neos CMS usando o seguinte comando:

MariaDB [(none)]> CREATE DATABASE neosdb;  
MariaDB [(none)]> CREATE USER 'neos'@'localhost' IDENTIFIED BY 'mypassword';

Em seguida, conceda todas as permissões ao banco de dados Neos com o seguinte comando:

MariaDB [(none)]> GRANT ALL PRIVILEGES ON neosdb.* TO 'neos'@'localhost' IDENTIFIED BY 'mypassword' WITH GRANT OPTION;

Em seguida, altere o charset do banco de dados para utf8mb4, limpe os privilégios e saia do MariaDB com o seguinte comando:

MariaDB [(none)]> ALTER DATABASE neosdb charset=utf8mb4;  
MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Em seguida, edite o arquivo de configuração do MariaDB e faça algumas alterações:

nano /etc/mysql/mariadb.conf.d/50-server.cnf

Adicione as seguintes linhas:

innodb_file_format = Barracuda
innodb_large_prefix = 1
innodb_file_per_table = 1
innodb_default_row_format = dynamic

Salve e feche o arquivo, então reinicie o serviço MariaDB para aplicar as alterações:

systemctl restart mariadb

Uma vez que você tenha terminado, pode prosseguir para o próximo passo.

Instalar Neos CMS

Antes de começar, você precisará instalar o Composer no seu sistema. O Composer é um gerenciador de dependências usado para instalar dependências PHP.

Execute o seguinte comando para instalar o Composer:

curl -sS https://getcomposer.org/installer | php

Você deve obter a seguinte saída:

All settings correct for using Composer
Downloading...

Composer (version 2.4.1) successfully installed to: /root/composer.phar
Use it: php composer.phar

Em seguida, mova o arquivo Composer para o local do sistema:

mv composer.phar /usr/local/bin/composer

Em seguida, mude o diretório para a raiz da web do Apache e baixe o Neos CMS com o seguinte comando:

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

Em seguida, renomeie o diretório baixado e execute o comando composer para instalar todas as dependências PHP:

mv neos-base-distribution neoscms  
cd neoscms   
composer install

Em seguida, defina as permissões e a propriedade adequadas para o diretório Neos:

chown -R www-data:www-data /var/www/html/neoscms/  
chmod -R 755 /var/www/html/neoscms/

Uma vez que você tenha terminado, pode prosseguir para o próximo passo.

Configurar o Apache para o Neos CMS

Em seguida, você precisará criar um arquivo de configuração de host virtual do Apache para hospedar o Neos CMS. Você pode criá-lo com o seguinte comando:

nano /etc/apache2/sites-available/neoscms.conf

Adicione as seguintes linhas:


     ServerAdmin [email protected]
     DocumentRoot /var/www/html/neoscms/Web
     ServerName neos.example.com
     
          Options FollowSymlinks
          AllowOverride All
          Require all granted
     

     ErrorLog ${APACHE_LOG_DIR}/neos_error.log
     CustomLog ${APACHE_LOG_DIR}/neos_access.log combined
    
     
            RewriteEngine on
            RewriteBase /
            RewriteCond %{REQUEST_FILENAME} !-f
            RewriteRule ^(.*) index.php [PT,L]
    

Salve e feche o arquivo, então ative o host virtual e habilite o módulo de reescrita do Apache com o seguinte comando:

a2ensite neoscms.conf  
a2enmod rewrite

Em seguida, reinicie o serviço Apache para aplicar as alterações:

systemctl restart apache2

Você também pode verificar o status do serviço Apache com o seguinte comando:

systemctl status apache2

Você deve obter a seguinte saída:

? apache2.service - The Apache HTTP Server
     Loaded: loaded (/lib/systemd/system/apache2.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2022-09-04 08:07:38 UTC; 8s ago
       Docs: https://httpd.apache.org/docs/2.4/
    Process: 22571 ExecStart=/usr/sbin/apachectl start (code=exited, status=0/SUCCESS)
   Main PID: 22577 (apache2)
      Tasks: 6 (limit: 4579)
     Memory: 14.7M
        CPU: 128ms
     CGroup: /system.slice/apache2.service
             ??22577 /usr/sbin/apache2 -k start
             ??22578 /usr/sbin/apache2 -k start
             ??22579 /usr/sbin/apache2 -k start
             ??22580 /usr/sbin/apache2 -k start
             ??22581 /usr/sbin/apache2 -k start
             ??22582 /usr/sbin/apache2 -k start

Sep 04 08:07:38 ubuntu2204 systemd[1]: Starting The Apache HTTP Server...

Neste ponto, o servidor web Apache está configurado para servir o Neos CMS. Você pode agora prosseguir para o próximo passo.

Acessar o Neos CMS

Agora, abra seu navegador web e acesse o Neos CMS usando a URL http://neos.example.com. Você será redirecionado para a seguinte página:

Neos CMS

Clique em Ir para configuração. Você deve ver a seguinte página:

Login

Forneça a senha de configuração do arquivo SetupPassword.txt e clique no botão Login. Você deve ver a seguinte página:

Requisitos do sistema

Certifique-se de que todas as extensões PHP necessárias estão instaladas, então clique no botão Próximo. Você deve ver a seguinte página:

Configurações do banco de dados

Forneça o nome do seu banco de dados, nome de usuário do banco de dados, host do banco de dados, senha e clique no botão Próximo. Você deve ver a seguinte página:

Conta de administrador

Forneça seu nome, nome de usuário do administrador, senha e clique no botão Próximo. Você deve ver a seguinte página:

Criar novo site

Configuração do Neos concluída

Clique em Ir para o backend. Você deve ver a página de login do Neos CMS:

Login do administrador do Neos

Forneça seu nome de usuário de administrador, senha e clique no botão Login. Você deve ver o painel do Neos CMS na seguinte página:

Painel do Neos

Proteger o Neos CMS com Let’s Encrypt

É uma boa ideia proteger seu site com o SSL gratuito Let’s Encrypt. Primeiro, instale o cliente Certbot para instalar e gerenciar o SSL. Você pode instalá-lo com o seguinte comando:

apt-get install python3-certbot-apache -y

Uma vez instalado, execute o seguinte comando para proteger seu site com o SSL Let’s Encrypt:

certbot --apache -d neos.example.com

Você será solicitado a fornecer seu email e aceitar os termos de serviço, como mostrado abaixo:

Saving debug log to /var/log/letsencrypt/letsencrypt.log
Plugins selected: Authenticator standalone, Installer None
Enter email address (used for urgent renewal and security notices) (Enter 'c' to
cancel): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Please read the Terms of Service at
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. You must
agree in order to register with the ACME server at
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Would you be willing to share your email address with the Electronic Frontier
Foundation, a founding partner of the Let's Encrypt project and the non-profit
organization that develops Certbot? We'd like to send you email about our work
encrypting the web, EFF news, campaigns, and ways to support digital freedom.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Plugins selected: Authenticator apache, Installer apache
Obtaining a new certificate
Performing the following challenges:
http-01 challenge for neos.example.com
Enabled Apache rewrite module
Waiting for verification...
Cleaning up challenges
Created an SSL vhost at /etc/apache2/sites-available/neos-le-ssl.conf
Enabled Apache socache_shmcb module
Enabled Apache ssl module
Deploying Certificate to VirtualHost /etc/apache2/sites-available/neos-le-ssl.conf
Enabling available site: /etc/apache2/sites-available/neos-le-ssl.conf

Em seguida, selecione se deseja ou não redirecionar o tráfego HTTP para HTTPS, como mostrado abaixo:

Please choose whether or not to redirect HTTP traffic to HTTPS, removing HTTP access.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: No redirect - Make no further changes to the webserver configuration.
2: Redirect - Make all requests redirect to secure HTTPS access. Choose this for
new sites, or if you're confident your site works on HTTPS. You can undo this
change by editing your web server's configuration.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Select the appropriate number [1-2] then [enter] (press 'c' to cancel): 2

Digite 2 e pressione Enter para instalar o SSL Let’s Encrypt para seu site:

Enabled Apache rewrite module
Redirecting vhost in /etc/apache2/sites-enabled/neos.conf to ssl vhost in /etc/apache2/sites-available/neos-le-ssl.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Congratulations! You have successfully enabled https://neos.example.com

You should test your configuration at:
https://www.ssllabs.com/ssltest/analyze.html?d=neos.example.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

IMPORTANT NOTES:
 - Congratulations! Your certificate and chain have been saved at:
   /etc/letsencrypt/live/neos.example.com/fullchain.pem
   Your key file has been saved at:
   /etc/letsencrypt/live/neos.example.com/privkey.pem
   Your cert will expire on 2022-12-07. To obtain a new or tweaked
   version of this certificate in the future, simply run certbot again
   with the "certonly" option. To non-interactively renew *all*
   of your certificates, run "certbot renew"
 - If you like Certbot, please consider supporting our work by:

   Donating to ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Donating to EFF:                    https://eff.org/donate-le

Conclusão

Parabéns! você instalou com sucesso o Neos CMS com Apache e SSL Let’s Encrypt no servidor Ubuntu 22.04. Agora você pode facilmente criar e editar seu site através do navegador web. Sinta-se à vontade para me perguntar se você tiver alguma dúvida.

Share: X/Twitter LinkedIn

Receba novas postagens na sua caixa de entrada

Sem spam. Cancele a assinatura a qualquer momento.