# Instalar Omeka S: banco, arquivos e publicação

Roteiro técnico de instalação do Omeka S com configuração database.ini e validação de mídia.

Editora: Arquindex. Revisão: 06/11/2026.

URL canônica: https://www.arquindex.com.br/open-source-documental/omeka/instalacao/

Escopo: Procedimento para instalação nova; configuração de Apache e banco depende do ambiente. Não executado nesta revisão.

## Resposta direta

Baixe o pacote de distribuição Omeka S, prepare banco dedicado, configure database.ini e o servidor web, habilite escrita em files/ e conclua pelo caminho /admin.

## 1. Verificar a release e os requisitos

A página de releases consultada direciona para Omeka S 4.2.1. Use o pacote de distribuição indicado pelo projeto; um arquivo de código-fonte do GitHub pode exigir build adicional. Confira PHP, extensões, banco e servidor web no manual da versão.

[Release Omeka S 4.2.1](https://github.com/omeka/omeka-s/releases/tag/v4.2.1) · [Catálogo oficial](https://omeka.org/s/download/)

## 2. Criar banco e usuário dedicados

Omeka S precisa de uma base própria. A equipe responsável pelo banco deve criar o schema e conceder somente as permissões necessárias ao usuário da aplicação.

## 3. Configurar a conexão

Após extrair o pacote, ajuste config/database.ini. Os valores a seguir são ilustrativos.



```text
user     = "omeka_app"
password = "SUBSTITUIR_PELO_SEGREDO_DO_AMBIENTE"
dbname   = "omeka_s"
host     = "127.0.0.1"
port     = 3306
```


## 4. Configurar o servidor web

Defina o diretório da aplicação no virtual host Apache e habilite as regras de reescrita exigidas pelo pacote. Garanta escrita em files/ para o usuário do processo web. Não use permissão 777 como solução genérica.

## 5. Inicializar pelo navegador

Acesse o caminho /admin da aplicação, crie a primeira conta e configure título, idioma e fuso. Guarde o segredo de conexão fora de repositórios públicos.

## 6. Validar mídia e tarefas

Crie um item com metadados e uma mídia de teste; confirme a miniatura e a publicação no site correto. Confira o caminho PHP CLI para jobs e a ferramenta de imagem. Um item cadastrado não é necessariamente um item publicado em todos os sites.

## Atualização e recuperação

Antes de atualizar, preserve banco, arquivos, configuração, módulos e temas; teste compatibilidade numa cópia. A recuperação deve restaurar também as configurações e extensões coerentes com os dados.

## Fontes do procedimento

[Manual oficial de instalação e atualização](https://omeka.org/s/open-source-documental/user-manual/install/) · [Release consultada](https://github.com/omeka/omeka-s/releases/tag/v4.2.1) · [Fórum](https://forum.omeka.org/)