From e78e13a6d44e63287284a362260471ad40f71f56 Mon Sep 17 00:00:00 2001 From: henmohr Date: Mon, 16 Nov 2026 16:29:06 -0300 Subject: [PATCH 1/2] add nextcloud setup how to Signed-off-by: henmohr --- source/_posts/nextcloud-em-5-passos.md | 157 +++++++++++++++++++++++++ 1 file changed, 157 insertions(+) create mode 100644 source/_posts/nextcloud-em-5-passos.md diff --git a/source/_posts/nextcloud-em-5-passos.md b/source/_posts/nextcloud-em-5-passos.md new file mode 100644 index 00000000..70a34e48 --- /dev/null +++ b/source/_posts/nextcloud-em-5-passos.md @@ -0,0 +1,157 @@ +--- +extends: _layouts.post +title: "Nextcloud: Setup em 5 passos" +author: Henrique Mohr +date: "2026-11-16" +description: "Guia rápido para instalar o Nextcloud com Docker Compose, PostgreSQL e Redis." + +--- + +Nextcloud é uma ferramenta incrível. Descubra como fazer o setup facilmente. + +Precisa de ajuda com seu Nextcloud? Entre em contato conosco. + +# Como subir o Nextcloud em 5 passos + +O Nextcloud permite criar uma nuvem própria para armazenar, sincronizar e compartilhar arquivos. Neste guia, você vai subir uma instalação básica usando Docker Compose, PostgreSQL e Redis. + +## 1. Prepare o servidor e o domínio + +Antes de começar, tenha: + +- um servidor com Docker e Docker Compose instalados; +- pelo menos 4 GB de memória e 20 GB de espaço em disco; +- um domínio apontando para o IP do servidor. + +Crie também as redes Docker usadas pelos serviços: + +```bash +docker network create postgres +docker network create redis +docker network create reverse-proxy +``` + +## 2. Suba o PostgreSQL e o Redis + +Crie um diretório para os serviços: + +```bash +mkdir -p /opt/infra-nextcloud +cd /opt/infra-nextcloud +``` + +Crie um arquivo `.env` com senhas fortes: + +```bash +POSTGRES_DB=nextcloud +POSTGRES_USER=nextcloud +POSTGRES_PASSWORD=troque-por-uma-senha-forte +REDIS_PASSWORD=troque-por-outra-senha-forte +TZ=America/Sao_Paulo +``` + +Depois, crie o arquivo `docker-compose.yml`: + +```yaml +networks: + postgres: + external: true + redis: + external: true + +services: + postgres: + image: postgres:17-alpine + container_name: postgres-postgres-1 + restart: unless-stopped + environment: + POSTGRES_DB: ${POSTGRES_DB} + POSTGRES_USER: ${POSTGRES_USER} + POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} + TZ: ${TZ} + volumes: + - ./volumes/postgres:/var/lib/postgresql/data + networks: + - postgres + + redis: + image: redis:alpine + container_name: redis-redis-1 + restart: unless-stopped + command: ["redis-server", "--appendonly", "yes", "--requirepass", "${REDIS_PASSWORD}"] + environment: + REDIS_PASSWORD: ${REDIS_PASSWORD} + volumes: + - ./volumes/redis:/data + networks: + - redis +``` + +Suba os serviços e verifique o funcionamento: + +```bash +docker compose up -d +docker compose ps +docker compose exec postgres pg_isready -U nextcloud +docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping' +``` + +Os dois últimos comandos devem indicar que o PostgreSQL está aceitando conexões e retornar `PONG` para o Redis. + +## 3. Baixe o projeto + +Clone o projeto da LibreCode e acesse o diretório: + +```bash +git clone https://github.com/LibreCodeCoop/nextcloud-docker /opt/nextcloud +cd /opt/nextcloud +``` + +## 4. Configure o ambiente + +Crie o arquivo de configuração a partir do exemplo: + +```bash +cp .env.example .env +nano .env +``` + +Preencha o domínio, o e-mail do certificado e o usuário administrador. Para conectar os serviços criados no passo 2, use: + +```bash +POSTGRES_HOST=postgres-postgres-1 +POSTGRES_DB=nextcloud +POSTGRES_USER=nextcloud +POSTGRES_PASSWORD=mesma-senha-definida-na-infra +REDIS_HOST=redis-redis-1 +REDIS_HOST_PORT=6379 +REDIS_HOST_PASSWORD=mesma-senha-definida-na-infra +``` + +Não publique os arquivos `.env` e use a mesma senha de cada serviço nos dois projetos. + +## 5. Suba e valide o Nextcloud + +Valide a configuração e inicie os serviços: + +```bash +docker compose config +docker compose up -d +docker compose logs -f app +``` + +Aguarde a conclusão da inicialização. Depois, abra no navegador o domínio configurado, por exemplo: `https://cloud.seudominio.com.br`. + +Confira também o estado da instalação: + +```bash +docker compose ps +docker compose exec -u www-data app php occ status +docker compose exec -u www-data app php occ check +``` + +No painel administrativo, revise os avisos em **Administração > Visão geral**. Para finalizar, configure backups automáticos do banco de dados, do arquivo `.env` e dos diretórios de configuração e dados. + +Pronto: seu Nextcloud já está no ar. + +Para configurações de produção, integrações e solução de problemas, entre em contato conosco! From ac453f0dc0e89ae20825c331031ec0af8d654e1b Mon Sep 17 00:00:00 2001 From: Henrique Date: Mon, 16 Nov 2026 19:08:12 -0300 Subject: [PATCH 2/2] Update nextcloud-em-5-passos.md Signed-off-by: Henrique --- source/_posts/nextcloud-em-5-passos.md | 150 +++++++++++-------------- 1 file changed, 68 insertions(+), 82 deletions(-) diff --git a/source/_posts/nextcloud-em-5-passos.md b/source/_posts/nextcloud-em-5-passos.md index 70a34e48..a487537f 100644 --- a/source/_posts/nextcloud-em-5-passos.md +++ b/source/_posts/nextcloud-em-5-passos.md @@ -3,155 +3,141 @@ extends: _layouts.post title: "Nextcloud: Setup em 5 passos" author: Henrique Mohr date: "2026-11-16" -description: "Guia rápido para instalar o Nextcloud com Docker Compose, PostgreSQL e Redis." +description: "Guia rápido para instalar o Nextcloud com Docker Compose, Nginx Proxy, PostgreSQL e Redis." --- -Nextcloud é uma ferramenta incrível. Descubra como fazer o setup facilmente. +Nextcloud é uma ferramenta incrível. Descubra como fazer o setup facilmente. Precisa de ajuda com seu Nextcloud? Entre em contato conosco. # Como subir o Nextcloud em 5 passos -O Nextcloud permite criar uma nuvem própria para armazenar, sincronizar e compartilhar arquivos. Neste guia, você vai subir uma instalação básica usando Docker Compose, PostgreSQL e Redis. +O Nextcloud permite criar uma nuvem própria para armazenar, sincronizar e compartilhar arquivos. Neste guia, você vai subir uma instalação com HTTPS automático usando os projetos da LibreCode: [nginx-proxy](https://github.com/LibreCodeCoop/nginx-proxy), [postgres-docker](https://github.com/LibreCodeCoop/postgres-docker) e [nextcloud-docker](https://github.com/LibreCodeCoop/nextcloud-docker), além do Redis. -## 1. Prepare o servidor e o domínio +## 1. Prepare o servidor e as redes -Antes de começar, tenha: +Você precisa de um servidor com Docker e Docker Compose e de um domínio apontando para o IP dele. -- um servidor com Docker e Docker Compose instalados; -- pelo menos 4 GB de memória e 20 GB de espaço em disco; -- um domínio apontando para o IP do servidor. - -Crie também as redes Docker usadas pelos serviços: +Crie as redes externas que conectam os serviços: ```bash +docker network create reverse-proxy docker network create postgres docker network create redis -docker network create reverse-proxy ``` -## 2. Suba o PostgreSQL e o Redis +## 2. Suba o proxy reverso -Crie um diretório para os serviços: +O proxy cuida do HTTPS com Let's Encrypt: ```bash -mkdir -p /opt/infra-nextcloud -cd /opt/infra-nextcloud +git clone https://github.com/LibreCodeCoop/nginx-proxy ~/projects/nginx-proxy +cd ~/projects/nginx-proxy +docker compose up -d ``` -Crie um arquivo `.env` com senhas fortes: +## 3. Suba o PostgreSQL e o Redis + +Clone o projeto do PostgreSQL, configure o `.env` e suba o serviço: ```bash -POSTGRES_DB=nextcloud -POSTGRES_USER=nextcloud -POSTGRES_PASSWORD=troque-por-uma-senha-forte -REDIS_PASSWORD=troque-por-outra-senha-forte -TZ=America/Sao_Paulo +git clone https://github.com/LibreCodeCoop/postgres-docker ~/projects/postgres +cd ~/projects/postgres +cp .env.example .env +nano .env +docker compose up -d ``` -Depois, crie o arquivo `docker-compose.yml`: +Agora o Redis. Crie o diretório e o arquivo `docker-compose.yml`: + +```bash +mkdir -p ~/projects/redis +cd ~/projects/redis +nano docker-compose.yml +``` ```yaml networks: - postgres: - external: true redis: external: true + name: redis services: - postgres: - image: postgres:17-alpine - container_name: postgres-postgres-1 - restart: unless-stopped - environment: - POSTGRES_DB: ${POSTGRES_DB} - POSTGRES_USER: ${POSTGRES_USER} - POSTGRES_PASSWORD: ${POSTGRES_PASSWORD} - TZ: ${TZ} - volumes: - - ./volumes/postgres:/var/lib/postgresql/data - networks: - - postgres - redis: image: redis:alpine - container_name: redis-redis-1 restart: unless-stopped - command: ["redis-server", "--appendonly", "yes", "--requirepass", "${REDIS_PASSWORD}"] - environment: - REDIS_PASSWORD: ${REDIS_PASSWORD} volumes: - - ./volumes/redis:/data + - ./volumes/redis/data:/data + - /etc/timezone:/etc/timezone:ro + - /etc/localtime:/etc/localtime:ro networks: - redis + environment: + - TZ=America/Sao_Paulo ``` -Suba os serviços e verifique o funcionamento: - ```bash docker compose up -d -docker compose ps -docker compose exec postgres pg_isready -U nextcloud -docker compose exec redis sh -c 'redis-cli -a "$REDIS_PASSWORD" ping' ``` -Os dois últimos comandos devem indicar que o PostgreSQL está aceitando conexões e retornar `PONG` para o Redis. - -## 3. Baixe o projeto - -Clone o projeto da LibreCode e acesse o diretório: - -```bash -git clone https://github.com/LibreCodeCoop/nextcloud-docker /opt/nextcloud -cd /opt/nextcloud -``` - -## 4. Configure o ambiente - -Crie o arquivo de configuração a partir do exemplo: +## 4. Baixe e configure o Nextcloud ```bash +git clone https://github.com/LibreCodeCoop/nextcloud-docker ~/projects/nextcloud +cd ~/projects/nextcloud cp .env.example .env nano .env ``` -Preencha o domínio, o e-mail do certificado e o usuário administrador. Para conectar os serviços criados no passo 2, use: +Preencha pelo menos: ```bash -POSTGRES_HOST=postgres-postgres-1 -POSTGRES_DB=nextcloud -POSTGRES_USER=nextcloud -POSTGRES_PASSWORD=mesma-senha-definida-na-infra -REDIS_HOST=redis-redis-1 -REDIS_HOST_PORT=6379 -REDIS_HOST_PASSWORD=mesma-senha-definida-na-infra +VIRTUAL_HOST=cloud.seudominio.com.br +LETSENCRYPT_HOST=cloud.seudominio.com.br +LETSENCRYPT_EMAIL=voce@seudominio.com.br +NEXTCLOUD_TRUSTED_DOMAINS=cloud.seudominio.com.br,web +NEXTCLOUD_ADMIN_USER=admin +NEXTCLOUD_ADMIN_PASSWORD=troque-por-uma-senha-forte +NEXTCLOUD_ADMIN_EMAIL=voce@seudominio.com.br +POSTGRES_PASSWORD=mesma-senha-do-postgres +TZ=America/Sao_Paulo ``` -Não publique os arquivos `.env` e use a mesma senha de cada serviço nos dois projetos. +Para o Nextcloud enxergar o Redis, crie o arquivo `docker-compose.override.yml`: -## 5. Suba e valide o Nextcloud +```yaml +networks: + redis: + external: true + name: redis -Valide a configuração e inicie os serviços: +services: + app: + networks: + - redis +``` + +## 5. Suba e valide o Nextcloud ```bash -docker compose config docker compose up -d docker compose logs -f app ``` -Aguarde a conclusão da inicialização. Depois, abra no navegador o domínio configurado, por exemplo: `https://cloud.seudominio.com.br`. - -Confira também o estado da instalação: +Aguarde a inicialização e acesse `https://cloud.seudominio.com.br`. Para conferir a instalação: ```bash docker compose ps -docker compose exec -u www-data app php occ status -docker compose exec -u www-data app php occ check +docker compose exec -u www-data app ./occ status ``` -No painel administrativo, revise os avisos em **Administração > Visão geral**. Para finalizar, configure backups automáticos do banco de dados, do arquivo `.env` e dos diretórios de configuração e dados. +Depois, revise os avisos em `https://cloud.seudominio.com.br/settings/admin/overview`. Se aparecer algo sobre índices, rode: + +```bash +docker compose exec -u www-data app ./occ db:add-missing-indices +``` -Pronto: seu Nextcloud já está no ar. +Pronto: seu Nextcloud já está no ar. -Para configurações de produção, integrações e solução de problemas, entre em contato conosco! +Para configurações de produção, backup automatizado, integrações e solução de problemas, entre em contato conosco!