Guias /

Instalação

/

Imagem Docker

Imagem Docker

Com este guia, você fará o download de um arquivo compose com tudo o que precisa para implantar seu próprio Piwigo com Docker.


Este guia pressupõe que você possa se conectar ao seu servidor via SSH e já tenha o Docker instalado. Caso contrário, siga a documentação oficial do Docker aqui.

Etapa 1 - Instalação do contêiner

Conecte-se ao seu servidor e crie uma pasta chamada Piwigo:

  • Baixe o arquivo compose.yaml de Piwigo/piwigo-docker

  • Você pode usar o curl para baixá-lo sem sair do terminal.

    curl -O "https://raw.githubusercontent.com/Piwigo/piwigo-docker/refs/heads/main/compose.yaml"

  • Crie um arquivo chamado .env, que deve conter o seguinte, com uma senha forte após o sinal de igual (sem aspas).

  • piwigo_port=8080
    db_user_password=
    timezone=
    PIWIGO_UID=
    PIWIGO_GID=

    Você pode usar o comando `truncate` para gerar uma senha válida:

    printf $(tr -dc '[:alnum:]' </dev/urandom | head -c64)"\n"

    Você pode alterar a porta exposta editando piwigo_port

    Alterar idioma de referência para Inglês [Reino Unido] Defina o UID e o GID do usuário e do grupo aos quais você deseja conceder acesso à pasta piwigo nos campos PIWIGO_UID e PIWIGO_GID

Inicie seu container com docker compose up -d

Etapa 2 - Configurar o proxy reverso

Você precisará usar um proxy reverso externo com o Piwigo Docker; você pode usar os seguintes exemplos de configuração do Nginx:

O Piwigo suporta hospedagem em um domínio, subdomínio e/ou subdiretório; seja qual for a sua escolha, recomenda-se não usar o número da versão do Piwigo na URL.

server {
	listen 80;
	server_name my_domain.tld;
	location / {
		proxy_pass http://127.0.0.1:8080/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
	}
}

Se você pretende hospedar o Piwigo em um subdiretório (ex: my_domain.tld/gallery), você precisará encaminhá-lo para o contêiner adicionando proxy_set_header X-Forwarded-Prefix /my_subpath

server {
	listen 80;
	server_name my_domain.tld;
	location /gallery/ {
		proxy_pass http://127.0.0.1:8080/;
		proxy_set_header Host $host;
		proxy_set_header X-Real-IP $remote_addr;
		proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
		proxy_set_header X-Forwarded-Proto $scheme;
		proxy_set_header X-Forwarded-Prefix /gallery;
    }
}

Etapa 3 - Configuração

Após iniciar o contêiner e configurar seu proxy reverso, abra um navegador da web no endereço onde o Piwigo está hospedado. O Piwigo detectará que nada está instalado ainda e o redirecionará para a página de instalação.

Se você alterou a variável de ambiente `piwigo_port` no arquivo `.env`, também precisará modificar a seção `proxy_pass` para refletir essa alteração. Lembre-se de que o Docker ignora todas as suas regras de firewall por padrão.

Preencha as configurações de conexão do banco de dados MySQL com o seguinte: :

  • Hospedeiro : piwigo-db:3306
  • Usuário : piwigodb_user
  • Senha : Use a senha que você escreveu no arquivo .env.
  • Nome do Banco de Dados : piwigodb
  • Um prefixo para os nomes das tabelas do Piwigo : piwigo_

É necessário o seguinte para criar a conta de administrador:

  • Um identificador de conta, escolhido por você
  • Uma senha que você deve digitar duas vezes, para verificação
  • Seu endereço de e-mail, para que os visitantes possam entrar em contato com você

Execute a ação "Iniciar instalação".

Lado da instalação

Você será informado sobre o sucesso ou falha do processo de instalação.

Instalação bem sucedida

Etapa 4 - Primeira conexão

Quando a instalação estiver concluída, você poderá acessar sua galeria. Faça login com sua conta de administrador e acesse o painel de administração.

Piwigo está instalado

Ainda tem alguma dúvida?

Você pode obter ajuda no fórum ou encontrar suas próprias respostas na documentação