Ambiente

Para esta documentação, vamos assumir que você está disposto a instalar o NexoPOS em um ambiente Linux. Como estamos direcionando especificamente o Ubuntu 24.04, isso também se aplica ao 22.04 e ao 26.06 (mais versões continuam compatíveis até o momento).

Para uma instalação nativa no Windows, consulte o NexoPOS para Windows. No entanto, isso também pode ser aplicado ao Windows Subsystem for Linux (WSL2).

Instalando PHP

Para instalar o PHP no seu ambiente, você precisará executar o seguinte comando:

sudo apt update 
sudo apt install -y software-properties-common ca-certificates lsb-release apt-transport-https 
sudo add-apt-repository -y ppa:ondrej/php 
sudo apt update

Agora, vamos prosseguir com a instalação dos módulos PHP necessários.

sudo apt install -y php8.4 php8.4-cli php8.4-fpm php8.4-common php8.4-mysql php8.4-zip php8.4-gd php8.4-mbstring php8.4-curl php8.4-xml php8.4-bcmath php8.4-intl php8.4-soap php8.4-readline php8.4-opcache php8.4-redis php8.4-imagick php8.4-sqlite3 unzip curl git

Você pode agora executar php -v para ver a versão do PHP instalada.

Instalando Nginx / Apache

Instalação do Nginx

Começaremos com o Nginx, que é a solução que usamos na maioria dos nossos projetos.

sudo apt update
sudo apt install -y nginx

Você pode eventualmente precisar habilitar o serviço Nginx, e isso pode ser feito desta forma:

sudo systemctl enable nginx 
sudo systemctl start nginx 
sudo systemctl status nginx

opcionalmente, você pode querer conceder acesso ao firewall para o nginx. Isso é possível com o seguinte comando:

sudo ufw allow 'Nginx Full'

Configuração do Apache

Se você estiver usando o Apache em vez do Nginx, o seguinte comando se aplica a você.

sudo apt update
sudo apt install -y apache2

Da mesma forma, se você quiser habilitar o serviço, será necessário executar o seguinte comando:

systemctl enable apache2 
sudo systemctl start apache2 
sudo systemctl status apache2

A mesma exceção de firewall pode ser aplicada ao Apache executando o seguinte comando:

sudo ufw allow 'Apache Full'

Como você está usando o Apache para o NexoPOS, algum módulo deve estar habilitado para o Apache:

sudo a2enmod rewrite headers env dir mime && sudo systemctl restart apache2

Instalando o Composer

O Composer é o gerenciador de dependências usado pelo Laravel e, portanto, é necessário para executar o NexoPOS. Ele cuida do download e do gerenciamento de todos os pacotes PHP necessários para a aplicação. Sem o Composer, o NexoPOS não consegue instalar ou funcionar corretamente.

Para instalar o Composer globalmente no Ubuntu 24.04, execute:

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');" && \
php composer-setup.php --install-dir=/usr/local/bin --filename=composer && \
php -r "unlink('composer-setup.php');"

Você pode verificar a instalação com:

composer --version

Instalando o MariaDB

O MariaDB é o mecanismo de banco de dados usado pelo NexoPOS para armazenar todos os dados da aplicação, incluindo vendas, produtos e configurações. Ele é totalmente compatível com o Laravel e oferece uma alternativa confiável e de alto desempenho ao MySQL.

sudo apt update 
sudo apt install -y mariadb-server mariadb-client 

Agora podemos habilitar o serviço usando os seguintes comandos:

sudo systemctl enable mariadb 
sudo systemctl start mariadb 
sudo systemctl status mariadb

Após a instalação, recomenda-se proteger o servidor de banco de dados:

sudo mysql_secure_installation

sudo mysql_secure_installation:

sudo mysql -u root -p

Instalando NVM e Node

O NVM (Node Version Manager) permite que você instale e gerencie várias versões do Node.js de forma fácil. Isso é útil para o NexoPOS ao construir ativos de front-end com ferramentas como o Vite.

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Em seguida, carregue o NVM na sua sessão atual:

export NVM_DIR="$HOME/.nvm" && [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"

Instale o Node.js 24 e defina-o como a versão padrão:

nvm install 24 && nvm use 24 && nvm alias default 24

Você pode verificar que tudo está funcionando com:

node -v && npm -v

O Node.js 24 será usado por padrão nas novas sessões de terminal.

Aprenda agora como prosseguir com a instalação.