Contato: contato@mapos.com.br
Feedback - Vote ou sugira melhorias
O Map-OS é um projeto open source mantido com muito esforço, dedicação e tempo. Se ele te ajuda no dia a dia, considere apoiar o desenvolvimento para que o sistema continue evoluindo, recebendo melhorias, correções e novos recursos.
Você pode contribuir de forma simples e segura pelo link abaixo:
Faça uma doação: https://donate.mapos.com.br
Toda contribuição, independente do valor, faz a diferença. Obrigado por apoiar o Map-OS!
Participe da comunidade oficial do Map-OS no WhatsApp para tirar dúvidas, trocar experiências e acompanhar novidades do projeto:
Entre na comunidade: https://chat.whatsapp.com/GVSg8tPQzXy0grfYpRfQps
O Map-OS é um projeto de código aberto mantido e desenvolvido pela empresa MountBit, responsável pela sua evolução contínua, correções e apoio à comunidade.
Quer ajudar a melhorar o Map-OS? Leia o Guia de Contribuição para saber como preparar o ambiente de desenvolvimento, o padrão de código adotado e como abrir um Pull Request.
Acesse seu MAP-OS de qualquer lugar com a SYSGO, a solução de hospedagem pensada para quem busca praticidade, segurança e estabilidade.
Com instalação automatizada, ambiente dedicado ao MAP-OS Oficial, suporte na configuração e utilização, backups e alta disponibilidade, a SYSGO ajuda você a manter seu sistema sempre em funcionamento com confiança.
Solicite seu acesso agora: Fale com um Especialista!
-
Faça o download do pacote da release (
vX.Y.Z-release.zip, que já traz oapplication/vendor) ou clone o repositório. -
Extraia o pacote e copie para seu webserver.
-
Se instalou pelo código-fonte (e não pelo zip da release), rode o comando
composer install --no-deva partir da raiz do projeto. -
Acesse sua URL e inicie a instalação, é bem simples, basta preencher as informações no assistente de instalação MAPOS (inclusive a pasta dos anexos, o
STORAGE_PATH, que deve ficar fora da pasta pública). O instalador cria o banco, aplica as atualizações do banco de dados e grava oapplication/.envsó para o dono do arquivo. Se não conseguir aplicar as atualizações, a tela final avisa e o painel mostra o aviso até você usarAtualizar banco de dados(Configurações > Sistema) ou rodarphp index.php tools migrate. Terminada a instalação, o instalador se bloqueia sozinho (install/instalado.lockeapplication/.env), mas apague a pastainstalldo servidor. -
Proteja o servidor web (veja Segurança do servidor):
application/não pode ser acessível pela URL, eSTORAGE_PATHdeve apontar para uma pasta fora da pasta pública. -
Configure o email de envio em Configurações > Sistema > E-mail .
-
Configurar cron jobs para envio de e-mail:
- */2 * * * * php /var/www/index.php email/process
- */5 * * * * php /var/www/index.php email/retry
- Faça o download dos arquivos.
- Instale o Docker e o Docker Compose.
- Entre na pasta
dockerno seu terminal e rode o comandodocker-compose up --force-recreate. - Acesse a URL
http://localhost:8000/no navegador e inicie a instalação. - Na etapa de configuração use as seguintes configurações:
1. Por favor, insira as informações da sua conexão de banco de dados.
Host: mysql
Usuário: mapos
Senha: mapos
Banco de Dados: mapos
2. Por favor, insira as informações para sua conta de administrador.
Configure do jeito que quiser.
3. Por favor, insira a URL.
URL: http://localhost:8000/
-
Configure o email de envio em Configurações > Sistema > E-mail .
Tutorial Instalação: https://youtu.be/NgXzzBB_2bM?si=FS_R2xq_W0Jnfn33
- Execute o Prompt de Comando ou PowerShell como Administrador;
- Execute o comando:
PowerShell -command "& { iwr https://raw.githubusercontent.com/RamonSilva20/mapos/master/install.bat -OutFile MapOS_Install.bat }; .\MapOS_Install.bat" - Siga as instrunções na tela.
- Abra o Terminal ou acesse seu servidor via SSH;
- Eleve o privilégio aplicando
sudo su(Recomendado); - Execute o comando:
curl -o MapOS_Install.sh -L https://raw.githubusercontent.com/RamonSilva20/mapos/master/install.sh && chmod +x MapOS_Install.sh && ./MapOS_Install.sh - Siga as instruções na tela.
- O servidor web deve entregar apenas
index.phpeassets/. Não deixeapplication/(onde ficam o.env, os logs e, semSTORAGE_PATH, os anexos),updates/nem arquivos.sqlacessíveis pela URL. No Apache isso depende de os.htaccessvalerem (AllowOverride); em Nginx, Caddy e outros, aplique as regras de docs/servidor-web.md. Depois de configurar, teste:curl -I https://seu-dominio/application/.envdeve responder 403 ou 404, nunca 200. - Defina
STORAGE_PATHnoapplication/.envcom uma pasta fora da pasta pública para os anexos de OS e os arquivos enviados (docs/armazenamento-de-arquivos.md). - Atrás de proxy reverso, preencha
APP_PROXY_IPS(docs/cookies-e-sessao.md). Os cabeçalhos de segurança e a CSP estão em docs/cabecalhos-de-seguranca.md. - Autenticação em dois fatores opcional em Meu perfil (docs/dois-fatores.md).
A v5 troca a interface, o armazenamento de arquivos e a autenticação, e exige PHP >= 8.5. Siga o guia Migração do Map-OS 4.x para a v5: backup, variáveis novas do .env, STORAGE_PATH, migrations, configuração do servidor web, o que muda para quem personalizou o painel ou usa a API, e como voltar atrás.
- Faça o backup do banco de dados (Configurações > Backup) e dos arquivos:
application/.env, a pasta doSTORAGE_PATH,assets/uploads,assets/userImagee qualquer personalização feita dentro deassets/img. - Substitua os arquivos pelos da nova versão (o zip da release já traz o
application/vendor; pelo código-fonte, rodecomposer install --no-devna raiz). - Restaure os backups para seus locais devidos.
- Logue como administrador, vá em Configurações > Sistema e clique em
Atualizar banco de dados. Obs.: Também é possível atualizar o banco de dados via terminal rodando o comandophp index.php tools migratea partir da raiz do projeto. - Pronto, sua atualização está concluída.
- Pare o docker de rodar.
- Faça o backup do banco de dados e dos arquivos, como na atualização acima.
- Substitua os arquivos pelos da nova versão.
- Entre na pasta
dockerno seu terminal e rode o comandodocker-compose up --force-recreate. - Logue como administrador, vá em Configurações > Sistema e clique em
Atualizar banco de dados(ou rodephp index.php tools migrate). - Restaure os backups para seus locais devidos.
Configurações > Atualizar > Verificar atualização baixa a última release com tag do repositório, confere o SHA256 do zip e guarda um backup dos arquivos trocados. Depois clique em Atualizar banco de dados. Por padrão só entram releases estáveis (UPDATER_PRERELEASES=true inclui pré-releases). O application/.env, os uploads, o application/storage e a pasta install/ nunca são alterados. Detalhes em docs/atualizacao.md.
Esse recurso vale a partir da v5. Quem está na 4.x deve usar o guia de migração acima.
| Versão | Branch | Situação | Suporte |
|---|---|---|---|
| Map-OS em Laravel | — | Em desenvolvimento | Sem data de lançamento |
| 5.x (atual) | master |
Ativa: novidades e correções | Suporte ativo até a versão em Laravel sair; segurança por mais 12 meses depois |
| 4.x | 4.x |
Só segurança | Até 30/04/2027 |
Quem está na 4.x deve migrar pelo guia de migração. O botão "Atualizar Mapos" da 4.55.5 segue o branch 4.x e não instala a v5.
Para listar todos os comandos de terminal disponíveis, basta executar o comando php index.php tools a partir da raiz do projeto, após feita todo o processo de instalação.
- PHP >= 8.5, com as extensões
curl,gd,mysqli,zip,mbstring,dom,xml,zlib,iconv,json,opensslefileinfo(o instalador confere todas) - MySQL >= 5.7 ou >= 8.0 (ou MariaDB)
- Composer >= 2, só para instalar pelo código-fonte (o zip da release já traz o
application/vendor) - Node >= 22, só para quem altera views, CSS ou bibliotecas de JavaScript (veja o Guia de Contribuição); instalar o Map-OS nunca exige Node
- Migração da 4.x para a v5
- Servidor web: o que não pode ser público
- Atualização pelo painel
- Armazenamento de arquivos (
STORAGE_PATH) - Autenticação da API
- Autenticação em dois fatores
- Cabeçalhos de segurança e CSP
- Cookies e sessão
- Design system (
DESIGN.md)
Ramon Silva |
|---|



