Create Stack for some Containers (with CIFS share)

[D3ltorohd]

Ask a Question!

Hello Com,

i have some problems, creating my first stack for paperlessngx to use external folders from the network (CIFS).

When i will deploy,after a while it comes this message.

Failed to deploy a stack: compose up operation failed: dependency failed to start: container PaperlessNGX-DB is unhealthy

I dont know where the error is. So lets start, what i have done.

The first , i add some volumes to save the data later on another system and not in the docker container itself. Its a Linux system with CIFS Shared Folders. From Windows i can connect to this folders read and write. So this is one of the volumes i have create with portainer.

So, this i do for 6 other volumes. Then i go to the Stack Section create new one, and at this lines, i found in another guide.

services:
  redis:
    image: redis:7
    command:
      - /bin/sh
      - -c
      - redis-server --requirepass redispass
    container_name: PaperlessNGX-REDIS
    hostname: paper-redis
    mem_limit: 512m
    mem_reservation: 256m
    cpu_shares: 768
    security_opt:
      - no-new-privileges:true
    read_only: true
    user: 1000:1000
    healthcheck:
      test: ["CMD-SHELL", "redis-cli ping || exit 1"]
    volumes:
      - /var/lib/docker/volumes/paperless_redis_samba:/data:rw
    environment:
      TZ: Europe/Berlin
    restart: on-failure:5

  db:
    image: postgres:17
    container_name: PaperlessNGX-DB
    hostname: paper-db
    mem_limit: 1g
    cpu_shares: 768
    security_opt:
      - no-new-privileges:true
    healthcheck:
      test: ["CMD", "pg_isready", "-q", "-d", "paperless", "-U", "paperlessuser"]
      timeout: 45s
      interval: 10s
      retries: 10
    volumes:
      - /var/lib/docker/volumes/paperless_pg_db_samba:/var/lib/postgresql/data:rw
    environment:
      POSTGRES_DB: paperless
      POSTGRES_USER: paperlessuser
      POSTGRES_PASSWORD: paperlesspass
    restart: on-failure:5

  gotenberg:
    image: gotenberg/gotenberg:latest
    container_name: PaperlessNGX-GOTENBERG
    hostname: gotenberg
    security_opt:
      - no-new-privileges:true
    user: 1000:1000
    command:
      - "gotenberg"
      - "--chromium-disable-javascript=true"
      - "--chromium-allow-list=file:///tmp/.*"
    restart: on-failure:5

  tika:
    image: ghcr.io/paperless-ngx/tika:latest
    container_name: PaperlessNGX-TIKA
    hostname: tika
    security_opt:
      - no-new-privileges:true
    user: 1000:1000
    restart: on-failure:5

  paperless:
    image: ghcr.io/paperless-ngx/paperless-ngx:latest
    container_name: PaperlessNGX
    hostname: paperless-ngx
    mem_limit: 6g
    cpu_shares: 1024
    security_opt:
      - no-new-privileges:true
    healthcheck:
      test: ["CMD", "curl", "-fs", "-S", "--max-time", "2", "http://localhost:8000"]
      interval: 30s
      timeout: 10s
      retries: 5
    ports:
      - 8033:8000
    volumes:
      - /var/lib/docker/volumes/paperless_db_config_samba:/usr/src/paperless/data:rw
      - /var/lib/docker/volumes/paperless_dokumente_samba:/usr/src/paperless/media:rw
      - /var/lib/docker/volumes/paperless_export_samba:/usr/src/paperless/export:rw
      - /var/lib/docker/volumes/paperless_consume_samba:/usr/src/paperless/consume:rw
      - /var/lib/docker/volumes/paperless_trash_samba:/usr/src/paperless/trash:rw
    environment:
      PAPERLESS_REDIS: redis://:redispass@paper-redis:6379
      PAPERLESS_DBENGINE: postgresql
      PAPERLESS_DBHOST: paper-db
      PAPERLESS_DBNAME: paperless
      PAPERLESS_DBUSER: paperlessuser
      PAPERLESS_DBPASS: paperlesspass
      PAPERLESS_EMPTY_TRASH_DIR: ../trash
      PAPERLESS_FILENAME_FORMAT: '{{ created_year }}/{{ correspondent }}/{{ document_type }}/{{ title }}'
      PAPERLESS_OCR_ROTATE_PAGES_THRESHOLD: 6
      PAPERLESS_TASK_WORKERS: 1
      USERMAP_UID: 1000
      USERMAP_GID: 1000
      PAPERLESS_TIME_ZONE: Europe/Berlin
      PAPERLESS_ADMIN_USER: xxx
      PAPERLESS_ADMIN_PASSWORD: xxx
      PAPERLESS_URL:
      PAPERLESS_CSRF_TRUSTED_ORIGINS:
      PAPERLESS_OCR_LANGUAGE: deu+eng
      PAPERLESS_TIKA_ENABLED: 1
      PAPERLESS_TIKA_GOTENBERG_ENDPOINT: http://gotenberg:3000
      PAPERLESS_TIKA_ENDPOINT: http://tika:9998
    restart: on-failure:5
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_healthy
      tika:
        condition: service_started
      gotenberg:
        condition: service_started

i have change only the volume path, the uid gid to 1000:1000 thats what i use on the docker system and the port 8033:8000. Port 8000 is already there so i change to 8033.

So go to deploy and after some time, the error message from my post comes. Done.

Greet's
D3ltoro

[Nick-Portainer]

Hello @D3ltorohd,

Paperless depends on the database being healthy before it can proceed. It looks like your database never reaches a healthy status during the health check, causing your deployment to fail.

This isn’t a Portainer issue, but I’d recommend checking the permissions on the deployment using the CIFS share and reviewing the database logs to identify why it’s failing to deploy. The Paperless community might be able to offer more information on what the Database is doing during deployment as well.

[D3ltorohd]

Hm my volume creation is right ? And the path in the stack is right written ?

This is the error message.

`initdb: error: directory "/var/lib/postgresql/data" exists but is not empty

initdb: hint: If you want to create a new database system, either remove or empty the directory "/var/lib/postgresql/data" or run initdb with an argument other than "/var/lib/postgresql/data".`

I did found the folder, when i connect to the docker system via ssh.

Must i have this /_data to in the path in the stack ? Like /var/lib/docker/volumes/paperless_pg_db_samba/_data

[Nick-Portainer]

Hi @D3ltorohd,

The issue here is that you are not using your volumes correctly.

volumes:
  - /var/lib/docker/volumes/paperless_db_config_samba:/usr/src/paperless/data:rw
  - /var/lib/docker/volumes/paperless_dokumente_samba:/usr/src/paperless/media:rw
  - /var/lib/docker/volumes/paperless_export_samba:/usr/src/paperless/export:rw
  - /var/lib/docker/volumes/paperless_consume_samba:/usr/src/paperless/consume:rw
  - /var/lib/docker/volumes/paperless_trash_samba:/usr/src/paperless/trash:rw

By defining your volumes this way, you have created bind mounts instead of using the named volumes you created. For more details on bind mounts, refer to the Docker documentation.

If you want to use the named volumes you created, you need to reference them correctly. Instead of creating new volumes, you should reference your existing CIFS-based volumes properly, as outlined in the Paperless documentation.

Here’s an example of how your docker-compose file should be structured:

services:
  redis:
    ...
    volumes:
      - paperless_redis_samba:/data:rw

...

volumes:
  paperless_redis_samba:
    external: true

Key differences:
• The volumes: block at the bottom explicitly tells Docker that the volume paperless_redis_samba already exists and should be used as an external volume via external: true.
• This ensures Docker uses the named volume correctly instead of treating it as a bind mount.

Summary:
You are currently using bind mounts instead of named volumes for your configuration. Adjusting your docker-compose file as shown above will allow Docker to correctly reference your existing volumes.

[D3ltorohd]

Thank you very much for your explanation. So i will try it, to become the right definition for the volume path.

One thing, i did not understand right.

Should i use volumes: two time or should it looks like this ?

 volumes:
      - paperless_db_config_samba:/usr/src/paperless/data:rw
      - paperless_dokumente_samba:/usr/src/paperless/media:rw
      - paperless_export_samba:/usr/src/paperless/export:rw
      - paperless_consume_samba:/usr/src/paperless/consume:rw
      - paperless_trash_samba:/usr/src/paperless/trash:rw
    paperless_db_config_samba:
    paperless_dokumente_samba:
    paperless_export_samba:
    paperless_consume_samba:
    paperless_trash_samba:
    external: true

or this one in the service paperless for example.

volumes:
      - paperless_db_config_samba:/usr/src/paperless/data:rw
      - paperless_dokumente_samba:/usr/src/paperless/media:rw
      - paperless_export_samba:/usr/src/paperless/export:rw
      - paperless_consume_samba:/usr/src/paperless/consume:rw
      - paperless_trash_samba:/usr/src/paperless/trash:rw

   volumes:
    paperless_db_config_samba:
    paperless_dokumente_samba:
    paperless_export_samba:
    paperless_consume_samba:
    paperless_trash_samba:
    external: true

I tried it, but this comes as an error ? Or should i find on paperless docu how to define the external path, i understand that right ?

Failed to deploy a stack: failed to load the compose file: validating /data/compose/7/docker-compose.yml: services.paperless Additional property paperless_consume_samba is not allowed

I tried many different ways to set the external thing but nothing works.