Pr\u00e9-requisitos:<\/p>\n
- \n
- Ubuntu 26.04<\/li>\n
- Acesso sudo<\/li>\n
- Conex\u00e3o com Internet<\/li>\n
- Pelo menos 4 GB RAM (8 GB recomendado)<\/li>\n<\/ul>\n
Sem enrola\u00e7\u00e3o, vamos aos passos:<\/p>\n
1. Atualizar o Ubuntu<\/strong><\/p>\n
Antes de instalar qualquer software \u00e9 recomend\u00e1vel atualizar os reposit\u00f3rios e aplicar as \u00faltimas atualiza\u00e7\u00f5es do sistema operacional.<\/p>\n
\r\n> sudo add-apt-repository universe\r\n> sudo apt update\r\n> sudo apt upgrade -y\r\n<\/pre>\n
2. Instalar apenas os pacotes necess\u00e1rios<\/strong><\/p>\n
Nesta etapa ser\u00e3o instaladas apenas as ferramentas utilizadas durante a instala\u00e7\u00e3o do Docker e administra\u00e7\u00e3o b\u00e1sica do servidor.<\/p>\n
\r\n> sudo apt install -y \\\r\n apt-transport-https \\\r\n ca-certificates \\\r\n curl \\\r\n gnupg \\\r\n lsb-release \\\r\n software-properties-common \\\r\n vim \\\r\n unzip \\\r\n wget \\\r\n htop \\\r\n net-tools \\\r\n jq\r\n<\/pre>\n
3. Adicionar os reposit\u00f3rios do Docker<\/strong><\/p>\n
O Docker mant\u00e9m seu pr\u00f3prio reposit\u00f3rio oficial. Nesta etapa iremos adicionar sua chave GPG e registrar o reposit\u00f3rio oficial no Ubuntu.<\/p>\n
\r\n> sudo mkdir -p \/etc\/apt\/keyrings\r\n\r\n> curl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg \\\r\n| sudo gpg --dearmor -o \/etc\/apt\/keyrings\/docker.gpg\r\n\r\n> sudo chmod a+r \/etc\/apt\/keyrings\/docker.gpg\r\n\r\n> echo \\\r\n\"deb [arch=$(dpkg --print-architecture) signed-by=\/etc\/apt\/keyrings\/docker.gpg] \\\r\nhttps:\/\/download.docker.com\/linux\/ubuntu \\\r\n$(lsb_release -cs) stable\" \\\r\n| sudo tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null\r\n<\/pre>\n
4. Instalar Docker<\/strong><\/p>\n
Agora instalaremos o Docker Engine, Docker Buildx e o Docker Compose Plugin.<\/p>\n
\r\n> sudo apt update\r\n\r\n> sudo apt install -y \\\r\n docker-ce \\\r\n docker-ce-cli \\\r\n containerd.io \\\r\n docker-buildx-plugin \\\r\n docker-compose-plugin\r\n<\/pre>\n
5. Habilitar Docker<\/strong><\/p>\n
Habilite o servi\u00e7o do Docker para que ele seja iniciado automaticamente sempre que o servidor for reiniciado.<\/p>\n
\r\n> sudo systemctl enable docker\r\n> sudo systemctl start docker\r\n<\/pre>\n
6. Ajustar timezone e sincronizar hor\u00e1rio<\/strong><\/p>\n
Manter o timezone correto facilita a an\u00e1lise de logs e evita problemas de hor\u00e1rio entre GeoServer, PostgreSQL e sistema operacional.<\/p>\n
\r\n> sudo timedatectl set-timezone America\/Sao_Paulo\r\n> timedatectl\r\n<\/pre>\n
7. Estrutura <\/strong><\/p>\n
A estrutura abaixo ser\u00e1 utilizada para organizar os arquivos do projeto e facilitar futuras manuten\u00e7\u00f5es.<\/p>\n
![\"\"](\"https:\/\/www.fernandoquadro.com.br\/html\/wp-content\/uploads\/2026\/07\/ChatGPT-Image-17-de-jul.-de-2026-16_40_00.png\")
<\/p>\n8. Criar a Estrutura<\/strong><\/p>\n
\r\n> mkdir -p \/opt\/geoserver3\r\n> cd \/opt\/geoserver3\r\n\r\n> mkdir -p data\/postgres\r\n> mkdir -p data\/geoserver\r\n> mkdir -p nginx\/conf.d\r\n> mkdir -p nginx\/logs\r\n> mkdir -p logs\r\n> mkdir -p backups\r\n<\/pre>\n
9. Criar o arquivo docker-compose.yaml<\/strong><\/p>\n
O arquivo docker-compose.yaml descreve toda a infraestrutura da aplica\u00e7\u00e3o e ser\u00e1 respons\u00e1vel por criar automaticamente os containers do PostgreSQL\/PostGIS, GeoServer e Nginx.<\/p>\n
\r\nnano docker-compose.yaml\r\n<\/pre>\n
Copie todo o conte\u00fado abaixo para o arquivo.<\/p>\n
\r\nservices:\r\n\r\n postgis:\r\n image: postgis\/postgis:18-3.6\r\n container_name: postgis\r\n\r\n restart: unless-stopped\r\n\r\n environment:\r\n POSTGRES_DB: ${POSTGRES_DB}\r\n POSTGRES_USER: ${POSTGRES_USER}\r\n POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}\r\n TZ: ${TZ}\r\n\r\n # Descomente as linhas abaixo apenas se desejar permitir acesso externo ao PostgreSQL.\r\n #ports:\r\n # - \"5432:5432\"\r\n\r\n volumes:\r\n - .\/data\/postgres:\/var\/lib\/postgresql\r\n\r\n healthcheck:\r\n test:\r\n [\r\n \"CMD-SHELL\",\r\n \"pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB} -h localhost\"\r\n ]\r\n interval: 10s\r\n timeout: 5s\r\n retries: 10\r\n start_period: 20s\r\n\r\n networks:\r\n - geoserver-network\r\n\r\n\r\n geoserver:\r\n image: docker.osgeo.org\/geoserver:3.0.0\r\n container_name: geoserver\r\n\r\n restart: unless-stopped\r\n\r\n depends_on:\r\n postgis:\r\n condition: service_healthy\r\n\r\n ports:\r\n - \"8080\"\r\n\r\n environment:\r\n TZ: ${TZ}\r\n\r\n PROXY_BASE_URL: ${PUBLIC_GEOSERVER_URL}\r\n\r\n INSTALL_EXTENSIONS: \"true\"\r\n\r\n STABLE_EXTENSIONS: \"excel,importer,image,web-resource,wps\"\r\n\r\n EXTRA_JAVA_OPTS: >-\r\n -Xms2G\r\n -Xmx4G\r\n -Duser.timezone=${TZ}\r\n -Dfile.encoding=UTF-8\r\n -Djava.awt.headless=true\r\n\r\n CORS_ENABLED: \"true\"\r\n CORS_ALLOWED_ORIGINS: \"*\"\r\n CORS_ALLOWED_METHODS: \"GET,POST,PUT,DELETE,HEAD,OPTIONS\"\r\n CORS_ALLOWED_HEADERS: \"Origin,Accept,X-Requested-With,Content-Type,Access-Control-Request-Method,Access-Control-Request-Headers,Authorization\"\r\n CORS_ALLOW_CREDENTIALS: \"false\"\r\n\r\n ROOT_WEBAPP_REDIRECT: \"true\"\r\n\r\n volumes:\r\n - .\/data\/geoserver:\/opt\/geoserver_data\r\n\r\n healthcheck:\r\n test:\r\n [\r\n \"CMD-SHELL\",\r\n \"curl --fail http:\/\/localhost:8080\/geoserver\/web\/ || exit 1\"\r\n ]\r\n interval: 30s\r\n timeout: 15s\r\n retries: 10\r\n start_period: 180s\r\n\r\n networks:\r\n - geoserver-network\r\n\r\n nginx:\r\n image: nginx:alpine\r\n container_name: nginx\r\n restart: unless-stopped\r\n\r\n depends_on:\r\n geoserver:\r\n condition: service_healthy\r\n\r\n ports:\r\n - \"80:80\"\r\n # Descomente a linha abaixo ap\u00f3s configurar HTTPS no Nginx.\r\n #- \"443:443\"\r\n\r\n volumes:\r\n - .\/nginx\/conf.d:\/etc\/nginx\/conf.d:ro\r\n - .\/nginx\/logs:\/var\/log\/nginx\r\n\r\n networks:\r\n - geoserver-network\r\n\r\nnetworks:\r\n geoserver-network:\r\n driver: bridge\r\n<\/pre>\nObserva\u00e7\u00e3o:<\/strong> Um dos benef\u00edcios da imagem oficial do GeoServer \u00e9 a possibilidade de instalar automaticamente as extens\u00f5es durante a inicializa\u00e7\u00e3o do container. Neste tutorial j\u00e1 deixamos configurados alguns dos plugins mais utilizados em projetos reais: Excel <\/strong>(exporta\u00e7\u00e3o de dados), Importer <\/strong>(importa\u00e7\u00e3o de arquivos), Image <\/strong>(suporte a imagens), Web Resource<\/strong> (recursos web) e WPS <\/strong>(Web Processing Service). Dessa forma, ao t\u00e9rmino da instala\u00e7\u00e3o, o ambiente j\u00e1 estar\u00e1 pronto para utiliza\u00e7\u00e3o, sem necessidade de instalar essas extens\u00f5es manualmente.<\/p>\n
Observa\u00e7\u00e3o:<\/strong> Os nomes informados na vari\u00e1vel STABLE_EXTENSIONS <\/strong>correspondem aos identificadores oficiais das extens\u00f5es utilizadas pela imagem Docker do GeoServer. A lista completa de plugins dispon\u00edveis e seus respectivos nomes pode ser consultada na documenta\u00e7\u00e3o oficial do Docker do GeoServer: Docker Container \u2013 Adding GeoServer Extensions<\/a>. Para conhecer a finalidade de cada extens\u00e3o, consulte tamb\u00e9m a documenta\u00e7\u00e3o oficial de extens\u00f5es do GeoServer: GeoServer Extensions Documentation<\/a>.<\/p>\n
E n\u00e3o esque\u00e7a de criar tamb\u00e9m o arquivo .env:<\/p>\n
\r\n> nano .env\r\n<\/pre>\n
E inserir o seguinte conte\u00fado:<\/p>\n
\r\nPOSTGRES_DB=geoserver\r\nPOSTGRES_USER=geoserver\r\nPOSTGRES_PASSWORD=SUBSTITUA_POR_UMA_SENHA_FORTE\r\n\r\nPUBLIC_GEOSERVER_URL=http:\/\/SEU_IP\/geoserver\r\n\r\nTZ=America\/Sao_Paulo\r\n<\/pre>\n
Substitua SUBSTITUA_POR_UMA_SENHA_FORTE <\/strong>por uma senha segura e SEU_IP <\/strong>pelo endere\u00e7o IP p\u00fablico do servidor antes de iniciar os containers.<\/p>\n
A vari\u00e1vel PUBLIC_GEOSERVER_URL <\/strong>deve apontar para o endere\u00e7o utilizado pelos usu\u00e1rios para acessar o GeoServer. Durante os testes ela pode utilizar o IP do servidor. Em ambientes de produ\u00e7\u00e3o recomenda-se utilizar um dom\u00ednio com HTTPS.<\/p>\n
Dica:<\/strong> Nunca publique este arquivo em reposit\u00f3rios Git p\u00fablicos, pois ele cont\u00e9m a senha do banco de dados.<\/p>\n
10. Criar o arquivo geoserver.conf<\/strong><\/p>\n
O Nginx ser\u00e1 utilizado como proxy reverso, permitindo acessar o GeoServer atrav\u00e9s da porta 80 e facilitando futuras configura\u00e7\u00f5es de HTTPS.<\/p>\n
\r\n> nano nginx\/conf.d\/geoserver.conf\r\n<\/pre>\n
E insira o seguinte conte\u00fado:<\/p>\n
\r\nserver {\r\n listen 80;\r\n server_name _;\r\n\r\n client_max_body_size 2G;\r\n\r\n location = \/ {\r\n return 302 \/geoserver\/web\/;\r\n }\r\n\r\n location \/geoserver\/ {\r\n proxy_pass http:\/\/geoserver:8080\/geoserver\/;\r\n\r\n proxy_set_header Host $http_host;\r\n proxy_set_header X-Real-IP $remote_addr;\r\n proxy_set_header X-Forwarded-Host $http_host;\r\n proxy_set_header X-Forwarded-Port $server_port;\r\n proxy_set_header X-Forwarded-Proto $scheme;\r\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\r\n\r\n proxy_connect_timeout 60s;\r\n proxy_send_timeout 600s;\r\n proxy_read_timeout 600s;\r\n\r\n proxy_request_buffering off;\r\n proxy_buffering off;\r\n }\r\n}\r\n<\/pre>\n11. Subir os containers<\/strong><\/p>\n
\r\n> docker compose up -d\r\n<\/pre>\n
Depois acesse no seu navegador http:\/\/SEU_IP\/geoserver<\/p>\n
12. Conclus\u00e3o<\/strong><\/p>\n
Agora voc\u00ea possui um ambiente moderno baseado em containers, executando o GeoServer 3, PostgreSQL 18\/PostGIS 3.6 e Nginx.<\/p>\n
Essa estrutura pode ser utilizada para estudos, treinamentos, desenvolvimento e tamb\u00e9m servir como base para ambientes de produ\u00e7\u00e3o de pequeno e m\u00e9dio porte.<\/p>\n","protected":false},"excerpt":{"rendered":"
Prezado leitor, Neste post irei apresentar como instalar o GeoServer 3 juntamente com o PostgreSQL 18\/PostGIS utilizando Docker em um servidor executando Ubuntu Linux 26.04. Ao final deste tutorial voc\u00ea ter\u00e1 um ambiente pronto para desenvolvimento, testes ou treinamentos, contendo:… Continue Reading →<\/a><\/p>\n","protected":false},"author":275,"featured_media":10365,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[24],"tags":[304,208,212,230],"class_list":["post-10355","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-gis","tag-docker","tag-geoserver","tag-postgis","tag-postgresql"],"_links":{"self":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts\/10355","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/users\/275"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/comments?post=10355"}],"version-history":[{"count":17,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts\/10355\/revisions"}],"predecessor-version":[{"id":10374,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/posts\/10355\/revisions\/10374"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/media\/10365"}],"wp:attachment":[{"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/media?parent=10355"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/categories?post=10355"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.fernandoquadro.com.br\/html\/wp-json\/wp\/v2\/tags?post=10355"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}