LogoLogo
  • Introduction
  • Installation
  • Upgrade Guide
  • Docker
  • Configuration
    • Configuration Overview
    • Configuration Reference
    • Hiding Files
  • Help & Support
    • Troubleshooting
    • Common Issues
  • Developers
    • Development Environment
Powered by GitBook
On this page
  • Running with docker run
  • Running with docker compose
  • Advanced docker compose usage

Was this helpful?

Edit on GitHub

Docker

PreviousUpgrade GuideNextConfiguration Overview

Last updated 19 days ago

Was this helpful?

Starting with Directory Lister v5.0 an as directorylister/directorylister.

Running with docker run

docker run --detach [--env ENVIRONMENT_VARIABLE=value] \
    --volume <host_path>:/data --publish <host_port>:80 \
    directorylister/directorylister:5

Replace <host_path> with the path to the directory you'd like to list.

Replace <host_port> with the port you would like to expose the application on.

You may pass one or more environment variables with multiple --env flags.

See the for a full list of the available environment variables.

Running with docker compose

The following is an example docker-compose.yaml file. For more information on docker compose and how to use this file see the .

docker-compose.yaml
services:

  directory-lister:
    image: directorylister/directorylister:<version>
    environment:
      # APP_LANGUAGE: en
      # DISPLAY_READMES: true
      # READMES_FIRST: false
      # ZIP_DOWNLOADS: true
      # TIMEZONE: America/Phoenix
      # See configuration docs for additional variables
    ports:
      - <host_port>:80
    volumes:
      - <host_path>:/data
    restart: unless-stopped

Replace <version> with the version of Directory Lister you'd like to use (e.g. 5.0.5, 5.0 or 5)

Replace <host_path> with the path to the directory you'd like to list.

Replace <host_port> with the port you would like to expose the application on.

Advanced docker compose usage

The following is an example docker-compose.yaml file showing Directory Lister being run with a Valkey container for caching.

docker-compose.yaml
services:

  directory-lister:
    image: directorylister/directorylister:<version>
    environment:
      CACHE_DRIVER: redis
      REDIS_HOST: cache
      REDIS_PORT: 6379
      # See configuration docs for additional variables
    ports:
      - <host_port>:80
    volumes:
      - <host_path>:/data
    depends_on: [cache]
    restart: unless-stopped

  cache:
    image: valkey:8
    restart: unless-stopped

Replace <version> with the version of Directory Lister you'd like to use (e.g. 5.0.5, 5.0 or 5)

Replace <host_path> with the path to the directory you'd like to list.

Replace <host_port> with the port you would like to expose the application on.

See the for a full list of the available environment variables.

official Docker image is provided
Configuration Reference
Docker Compose documentation
Configuration Reference