![\"Mascote](\"\/wp-content\/uploads\/2026\/09\/opencms-v3.webp\")
<\/p>\n<\/p>\n
wget<\/code> do OpenCms 10.5 beta descompactado no Tomcat. Hoje a linha est\u00e1vel \u00e9 a 21<\/strong> (build 21.0.1, abril de 2026), existe imagem Docker oficial e o proxy AJP do post original virou risco de seguran\u00e7a. Abaixo, o caminho atual \u2014 e a hist\u00f3ria do projeto, que \u00e9 mais interessante do que parece. O texto de 2017 fica preservado no fim.<\/div>\nO OpenCms \u00e9 um gerenciador de conte\u00fado web escrito em Java<\/strong>, livre sob licen\u00e7a LGPL<\/strong>, mantido pela alem\u00e3 Alkacon Software. N\u00e3o \u00e9 o CMS que voc\u00ea instala num compartilhado de R$ 20 \u2014 \u00e9 o que empresa e \u00f3rg\u00e3o p\u00fablico colocam num Tomcat para gerenciar site institucional com fluxo de aprova\u00e7\u00e3o, versionamento e m\u00faltiplos idiomas.<\/p>\nDe onde veio o OpenCms<\/h2>\n
A hist\u00f3ria come\u00e7a antes do nome. Entre 1994 e 1998<\/strong>, Alexander Kandzior<\/strong> desenvolveu na BKM Online medien GmbH um sistema chamado Mht<\/strong> \u2014 Meta-Hyper-Text<\/em>. Era c\u00f3digo fechado, ferramenta de uso interno de uma consultoria.<\/p>\nEm 1998 a BKM se fundiu e virou a mindfact interactive medien AG<\/strong>. E aqui est\u00e1 a decis\u00e3o que criou o projeto: como o neg\u00f3cio da mindfact era consultoria de internet, n\u00e3o venda de software, a empresa concluiu que n\u00e3o fazia sentido guardar o c\u00f3digo. A vers\u00e3o seguinte do Mht foi publicada como software livre.<\/p>\nO lan\u00e7amento p\u00fablico aconteceu em mar\u00e7o de 2000<\/strong>, sob LGPL<\/strong>, com nome novo: OpenCms. Depois Kandzior fundou a Alkacon Software<\/strong>, em Col\u00f4nia, que coordena o desenvolvimento at\u00e9 hoje. \u00c9 o mesmo padr\u00e3o do OTRS<\/a> e do GLPI<\/a>: ferramenta interna de uma empresa alem\u00e3 ou francesa que vira projeto livre e ganha uma editora em volta.<\/p>\nO que o distingue dos dois \u00e9 a plataforma. Enquanto o GLPI \u00e9 PHP e o OTRS \u00e9 Perl, o OpenCms sempre foi Java puro<\/strong> \u2014 o que explica tanto a sua for\u00e7a (roda em qualquer sistema com JVM, escala em container de servlet) quanto o seu nicho (voc\u00ea precisa de um Tomcat, e isso afasta metade do mercado).<\/p>\nO que ele faz<\/h2>\n\n- Edi\u00e7\u00e3o no lugar<\/strong> \u2014 o editor funciona sobre a pr\u00f3pria p\u00e1gina, sem painel separado.<\/li>\n
- Fluxo de publica\u00e7\u00e3o<\/strong> \u2014 o conte\u00fado vive num projeto offline<\/em> e s\u00f3 vai ao ar quando algu\u00e9m publica. Nada de “salvei e foi para produ\u00e7\u00e3o”.<\/li>\n
- Versionamento<\/strong> \u2014 hist\u00f3rico de cada arquivo, com rollback<\/em>.<\/li>\n
- Conte\u00fado estruturado em XML<\/strong> \u2014 o conte\u00fado tem esquema, n\u00e3o \u00e9 um campo de texto rico solto.<\/li>\n
- Multi-site e multi-idioma<\/strong> num s\u00f3 servidor.<\/li>\n
- Mercury<\/strong> \u2014 o template moderno, responsivo, que vem junto com a distribui\u00e7\u00e3o.<\/li>\n<\/ul>\n
Requisitos em 2026<\/h2>\n
Aqui est\u00e1 a mudan\u00e7a que mais quebra instala\u00e7\u00e3o antiga: o OpenCms 21 exige Java 21 ou mais novo<\/strong>, e \u00e9 compat\u00edvel at\u00e9 o Java 25. E precisa ser o JDK<\/strong>, n\u00e3o o JRE.<\/p>\n\n- Java<\/strong>: JDK 21 ou superior.<\/li>\n
- Cont\u00eainer de servlet<\/strong>: Tomcat<\/a> ou Jetty.<\/li>\n
- Banco<\/strong>: MariaDB ou MySQL \u2014 com o ajuste de blob size<\/em> antes de instalar, ou a instala\u00e7\u00e3o falha no meio.<\/li>\n<\/ul>\n
O caminho curto: Docker<\/h2>\n
N\u00e3o existia em 2017 e resolve o problema inteiro: a Alkacon publica imagem oficial, com Java e Tomcat j\u00e1 na vers\u00e3o certa.<\/p>\n
services:\n db:\n image: mariadb:11\n restart: always\n command: --max_allowed_packet=64M --innodb_log_file_size=256M\n environment:\n MARIADB_ROOT_PASSWORD: troque-esta-senha\n volumes:\n - .\/dbdata:\/var\/lib\/mysql\n\n opencms:\n image: alkacon\/opencms-docker:21.0.1\n restart: always\n depends_on: [db]\n ports:\n - \"127.0.0.1:8080:8080\"\n volumes:\n - .\/opencms:\/usr\/local\/tomcat\/webapps\/ROOT\/WEB-INF\/config<\/code><\/pre>\ndocker compose up -d\n# assistente de instala\u00e7\u00e3o: http:\/\/127.0.0.1:8080\/setup\/<\/code><\/pre>\nInstala\u00e7\u00e3o manual no Tomcat<\/h2>\n
Se voc\u00ea prefere controlar cada pe\u00e7a, o caminho continua sendo o mesmo de 2017 \u2014 com as vers\u00f5es atualizadas.<\/p>\n
1. O ajuste do banco que ningu\u00e9m pode pular.<\/strong> O OpenCms guarda os arquivos como BLOB no banco, e o pacote padr\u00e3o do MariaDB \u00e9 pequeno demais. Sem isso, a instala\u00e7\u00e3o quebra ao importar os m\u00f3dulos:<\/p>\nsudo tee \/etc\/mysql\/mariadb.conf.d\/60-opencms.cnf >\/dev\/null <<'EOF'\n[mysqld]\nmax_allowed_packet = 64M\ninnodb_log_file_size = 256M\nEOF\n\nsudo systemctl restart mariadb\nsudo mariadb -e \"SHOW VARIABLES LIKE 'max_allowed_packet';\"<\/code><\/pre>\nsudo mariadb -e \"CREATE DATABASE opencms CHARACTER SET utf8mb4;\"\nsudo mariadb -e \"CREATE USER 'opencms'@'localhost' IDENTIFIED BY 'troque-esta-senha';\"\nsudo mariadb -e \"GRANT ALL ON opencms.* TO 'opencms'@'localhost'; FLUSH PRIVILEGES;\"<\/code><\/pre>\n2. Java e Tomcat.<\/strong> Confira a vers\u00e3o antes de baixar qualquer coisa \u2014 \u00e9 aqui que a maioria das instala\u00e7\u00f5es de 2017 morre hoje:<\/p>\nsudo apt install -y openjdk-21-jdk\njava -version # precisa ser 21 ou mais novo<\/code><\/pre>\n3. O OpenCms.<\/strong> Baixe o pacote da p\u00e1gina oficial de download<\/a> \u2014 ele traz o n\u00facleo mais o template Mercury:<\/p>\nsudo systemctl stop tomcat\n\ncd \/tmp\nunzip opencms-*.zip\nsudo mkdir -p \/usr\/local\/tomcat\/webapps\/opencms\nsudo unzip -d \/usr\/local\/tomcat\/webapps\/opencms opencms.war\nsudo chown -R tomcat:tomcat \/usr\/local\/tomcat\/webapps\/opencms\n\nsudo systemctl start tomcat\n# assistente: http:\/\/SEU-SERVIDOR:8080\/opencms\/setup\/<\/code><\/pre>\nTerminado o assistente, apague o diret\u00f3rio de setup<\/strong> \u2014 deix\u00e1-lo no ar \u00e9 convite aberto:<\/p>\nsudo rm -rf \/usr\/local\/tomcat\/webapps\/opencms\/setup<\/code><\/pre>\nnginx na frente (e por que o AJP saiu)<\/h2>\n
O post original usava mod_proxy_ajp<\/code> do Apache. N\u00e3o fa\u00e7a mais isso.<\/strong> O conector AJP foi alvo do Ghostcat<\/em> (CVE-2020-1938), que permitia ler arquivo arbitr\u00e1rio da aplica\u00e7\u00e3o, e desde o Tomcat 9.0.31 ele vem desabilitado por padr\u00e3o \u2014 quando existe. Use HTTP simples:<\/p>\nserver {\n listen 443 ssl;\n http2 on;\n server_name site.exemplo.com.br;\n\n ssl_certificate \/etc\/letsencrypt\/live\/site.exemplo.com.br\/fullchain.pem;\n ssl_certificate_key \/etc\/letsencrypt\/live\/site.exemplo.com.br\/privkey.pem;\n\n client_max_body_size 200m; # upload de m\u00eddia no editor\n\n location \/ {\n proxy_pass http:\/\/127.0.0.1:8080;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n }\n}<\/code><\/pre>\nE feche a 8080 no firewall: o Tomcat nunca deve estar acess\u00edvel direto da internet.<\/p>\n
Vale a pena em 2026?<\/h2>\n
Depende de onde voc\u00ea est\u00e1:<\/p>\n
\n- Faz sentido<\/strong> se a sua casa j\u00e1 \u00e9 Java, se voc\u00ea precisa de fluxo de aprova\u00e7\u00e3o editorial de verdade, versionamento e multi-idioma, e se o site \u00e9 institucional com muitos editores e regras de publica\u00e7\u00e3o.<\/li>\n
- N\u00e3o faz sentido<\/strong> se voc\u00ea quer blog ou loja: o ecossistema PHP<\/a> tem WordPress e Magento com uma ordem de grandeza mais de temas, plugins e gente que sabe mexer.<\/li>\n
- A conta de infraestrutura \u00e9 outra.<\/strong> JVM, Tomcat e um banco com blob grande pedem mais mem\u00f3ria do que um PHP-FPM. N\u00e3o \u00e9 caso de VPS de 1 GB.<\/li>\n
- A comunidade \u00e9 pequena.<\/strong> Pouco mais de 500 estrelas no GitHub e uma lista de discuss\u00e3o de ritmo tranquilo. Em compensa\u00e7\u00e3o, o projeto entrega vers\u00e3o nova pontualmente h\u00e1 vinte e cinco anos \u2014 e em 2026 at\u00e9 tradu\u00e7\u00e3o por IA no editor de conte\u00fado entrou.<\/li>\n<\/ul>\n
Linha do tempo<\/h2>\n\n- 1994\u20131998<\/strong> \u2014 Alexander Kandzior desenvolve o Mht<\/strong> (Meta-Hyper-Text) na BKM Online medien, c\u00f3digo fechado.<\/li>\n
- 1998<\/strong> \u2014 a BKM vira mindfact interactive medien AG, que decide abrir o c\u00f3digo: consultoria n\u00e3o vive de vender software.<\/li>\n
- Mar\u00e7o de 2000<\/strong> \u2014 primeiro lan\u00e7amento p\u00fablico como OpenCms<\/strong>, sob LGPL.<\/li>\n
- 2000s<\/strong> \u2014 Kandzior funda a Alkacon Software<\/strong>, em Col\u00f4nia, que assume o desenvolvimento.<\/li>\n
- 2011<\/strong> \u2014 o c\u00f3digo vai para o GitHub, em
alkacon\/opencms-core<\/code>.<\/li>\n- 2017<\/strong> \u2014 a vers\u00e3o 10.5, que este post originalmente ensinava a instalar.<\/li>\n
- Abril de 2026<\/strong> \u2014 OpenCms 21<\/strong> (build 21.0.1): exige Java 21, compat\u00edvel com o 25, e traz tradu\u00e7\u00e3o por IA no editor de XML.<\/li>\n<\/ul>\n
\nO post original (abril de 2017)<\/h2>\n
Preservado como registro. O procedimento abaixo instalava o OpenCms 10.5 beta e n\u00e3o deve ser usado hoje<\/strong> \u2014 a URL saiu do ar, a vers\u00e3o \u00e9 obsoleta e o proxy AJP n\u00e3o \u00e9 mais recomendado:<\/p>\n## Aumentar o max_allowed_packet do MariaDB para 32M\nFILE_DB=\/etc\/mysql\/mariadb.conf.d\/50-server.cnf\nsed -i \"s|max_allowed_packet= 16M|max_allowed_packet= 32M|\" ${FILE_DB}\nservice mysql restart\n\nsystemctl stop tomcat\ncd \/tmp\/\nwget http:\/\/www.opencms.org\/downloads\/opencms\/opencms-10.5.0_beta.zip\nunzip opencms-10.5.0_beta.zip\nunzip -d opencms opencms.war\nmv opencms \/usr\/local\/tomcat\/webapps\/\nchown -R tomcat:tomcat \/usr\/local\/tomcat\/webapps\/*\nsystemctl start tomcat\n## http:\/\/seu_server:8080\/opencms\/setup\/<\/code><\/pre>\nGist original: jniltinho\/a7bd30288342a5d352e6<\/a><\/p>\nLinks<\/h2>\n\n- opencms.org<\/a> \u00b7 download<\/a> \u00b7 documenta\u00e7\u00e3o<\/a><\/li>\n
- github.com\/alkacon\/opencms-core<\/a> \u00b7 Alkacon Software<\/a><\/li>\n
- Aqui no blog: Instalando o Tomcat no Linux<\/a> \u00b7 Nginx como proxy reverso<\/a> \u00b7 As principais linguagens de programa\u00e7\u00e3o<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
O OpenCms \u00e9 um gerenciador de conte\u00fado web escrito em Java, livre sob licen\u00e7a LGPL, mantido pela alem\u00e3 Alkacon Software. N\u00e3o \u00e9 o CMS que voc\u00ea instala num compartilhado de R$ 20 \u2014 \u00e9 o que empresa e \u00f3rg\u00e3o p\u00fablico … Read more<\/a><\/p>","protected":false},"author":0,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[65,14,64,4,63],"class_list":["post-125","post","type-post","status-publish","format-standard","hentry","category-linux","tag-cms","tag-howto","tag-java","tag-linux","tag-tomcat"],"_links":{"self":[{"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/posts\/125","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/comments?post=125"}],"version-history":[{"count":6,"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/posts\/125\/revisions"}],"predecessor-version":[{"id":1309,"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/posts\/125\/revisions\/1309"}],"wp:attachment":[{"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/media?parent=125"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/categories?post=125"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.linuxpro.com.br\/es\/wp-json\/wp\/v2\/tags?post=125"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}