MuCRMDocs
Site

Instalação & Requisitos

v4

A MuCRM v4 roda em hospedagem compartilhada e em VPS. O instalador web cobre banco, schemas e lock de instalação — SSH/terminal não é obrigatório.

💡Sem terminal obrigatório

Você pode subir os arquivos via FTP/painel, apontar o document root para public/ e concluir tudo pela interface web do instalador.

Requisitos do sistema

Obrigatórios

RequisitoVersão / Notas
PHP8.3+
ionCube LoaderNecessário para carregar o core protegido
GDUpload, WebP, avatars, guild marks
intlSlugs e normalização de texto

Recomendados

curl
mbstring
openssl
pdo_mysql
pdo_sqlsrv
pdo_dblib
fileinfo
zip

Como verificar

Crie um arquivo temporário public/check.php:

<?php phpinfo();

Confirme no navegador:

  • PHP 8.3 ou superior
  • ionCube ativo
  • gd ativo
  • intl ativo
🚨Remova depois

Apague check.php após a verificação — ele expõe informações sensíveis do servidor.

Instalação via interface web

1

Envie os arquivos do projeto para o servidor (FTP, File Manager, deploy).

2

Configure o document root para a pasta public/.

3

Acesse o domínio no navegador — o instalador abre automaticamente se não existir install/install.lock.

4

Escolha o driver de banco: SQL Server ou MySQL.

5

Informe host, usuário, senha e database.

6

Confirme a instalação.

O instalador aplica automaticamente os schemas compatíveis com o driver:

install/schemas/
├── mysql/
│   ├── mucrm_api_tokens.sql
│   ├── mucrm_jobs.sql
│   └── mucrm_failed_jobs.sql
└── sqlsrv/
    ├── mucrm_api_tokens.sql
    ├── mucrm_jobs.sql
    └── mucrm_failed_jobs.sql
ℹ️Reinstalar

Para rodar o instalador de novo, remova install/install.lock. Filhas com FK são dropadas antes dos pais.

Hospedagem compartilhada

Solicite ao provedor:

  • PHP 8.3+
  • ionCube Loader
  • GD + intl
  • PDO do seu banco (MySQL e/ou SQL Server)

Não é necessário acesso SSH para o fluxo padrão de instalação.

VPS / servidor próprio (opcional)

Se tiver terminal, exemplos comuns:

php8.3-gd
php8.3-intl
php8.3-curl
php8.3-mbstring
php8.3-mysql   # ou drivers SQL Server

Comandos opcionais de produção (quando houver CLI):

php mucrm cache:compile
php mucrm cron:run
php mucrm jobs:run
⚠️CLI é opcional

Cache compilado, cron e workers melhoram produção, mas o site e a API funcionam após o instalador web sem esses comandos.

Checklist pós-instalação

Próximo: Estrutura de Pastas.