docker/

Docker and Docker Compose configuration

As a convenience, we also provide a pre-built Docker image of Pydio Cells that is hosted on the Docker hub. As you can see in the dockerfile, the config is quite straight forward.

Important points:

• Cells working directory is set to /var/cells
• Image is run with root user
• Internal proxy configuration can be configure via environment variables or json / yaml config file.

Simply launch the image, it starts in configuration mode: you can fine tune your instance via your preferred web browser.
By default the server starts in self-signed mode on port 8080. You can modify the configuration to also use:

• A custom certificate that you provide.
• A certificate auto magically created using the tools provided by Let's Encrypt
• No certificate

Below are relevant samples of docker-compose files to achieve these use cases.

We also provide a few sample docker compose configurations as examples that are working out-of-the-box, if you only provide your public IP / valid domain name, see compose subdirectory.

Sample config for the Pydio Cells internal gateway

Default config

This starts Cells and exposes the server with a self-signed certificate on port 8080. You can reach the web interface using the IP address of your server or any FQDN that has been registered in a DNS and points toward this IP, together with explicit port 8080.
For instance: https://1.2.3.4:8080 or https://example.com:8080.

  cells:
    image: pydio/cells:latest
    restart: unless-stopped
    ports: ["8080:8080"]

Without certificate (via HTTP)

  cells:
    image: pydio/cells:latest
    restart: unless-stopped
    ports: ["8080:8080"]
    environment:
      - CELLS_NO_TLS=1

With Let's Encrypt

  cells:
    image: pydio/cells:latest
    restart: unless-stopped
    ports: ["80:80", "443:443"]
    environment:
      - CELLS_BIND=your.fqdn.com:443
      - CELLS_EXTERNAL=https://your.fqdn.com
      - CELLS_LE_EMAIL=admin@example.com
      - CELLS_LE_AGREE=1

Using a custom certificate

  cells:
    image: pydio/cells:latest
    restart: unless-stopped
    volumes: ["/path/to/your/ssl.cert:/etc/ssl/ssl.cert", "/path/to/your/ssl.key:/etc/ssl/ssl.key"]
    ports: ["443:443"]
    environment:
      - CELLS_BIND=0.0.0.0:443
      - CELLS_EXTERNAL=https://your.fqdn.com
      - CELLS_TLS_CERT_FILE=/etc/ssl/ssl.cert
      - CELLS_TLS_KEY_FILE=/etc/ssl/ssl.key