pixelfed/docker/faq.md

1.4 KiB

Pixelfed Docker FAQ

I already have a Proxy, how do I disable the included one?

No problem! All you have to do is:

  1. Change the DOCKER_PROXY_PROFILE key/value pair in your .env file to "disabled".
    • This disables the proxy and proxy-acme services in docker-compose.yml.
    • The setting is near the bottom of the file.
  2. Point your proxy upstream to the exposed web port (Default: 8080).
    • The port is controlled by the DOCKER_WEB_PORT_EXTERNAL_HTTP key in .env.
    • The setting is near the bottom of the file.

I already have a SSL certificate, how do I use it?

  1. Change the DOCKER_PROXY_ACME_PROFILE key/value pair in your .env file to "disabled".
    • This disabled the proxy-acme service in docker-compose.yml.
    • It does not disable the proxy service.
  2. Put your certificates in ${DOCKER_CONFIG_ROOT}/proxy/certs (e.g. ./docker-compose/config/proxy/certs)
    • You may need to create this folder manually if it does not exists.
    • The following files are expected to exist in the directory for the proxy to detect and use them automatically (this is the same directory and file names as LetsEncrypt uses)
      1. ${APP_DOMAIN}.cert.pem
      2. ${APP_DOMAIN}.chain.pem
      3. ${APP_DOMAIN}.fullchain.pem
      4. ${APP_DOMAIN}.key.pem
    • See the nginx-proxy configuration file for name patterns