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
  • The .env File
  • Advanced Configuration
  • Icon Configuration
  • Analytics Script Injection

Was this helpful?

Edit on GitHub
  1. Configuration

Configuration Overview

Directory Lister is customizable through configuration. You can configure Directory Lister in a few different ways.

The .env File

This is the recommended method of configuring Directory Lister.

Most configuration changes are possible via a custom .env file. This file defines environment variables and their value. To get started:

  1. Copy .env.example to .env

  2. Edit the configuration values in .env

Your default .env file should look something like this:

APP_DEBUG=false
APP_LANGUAGE=en

# FILES_PATH=

DISPLAY_READMES=true
READMES_FIRST=false
ZIP_DOWNLOADS=true

SORT_ORDER=type
REVERSE_SORT=false

Advanced Configuration

More control can be achieved via the application config files located in app/config. Here you have full control over each option and can even write full PHP code if desired. The application configs are broken up into separate files based on their use. Reference the individual config documentation for more information about individual application configuration options.

Take care when upgrading your Directory Lister installation as the files in app/config may be overwritten if you copy/paste and replace all files.

Icon Configuration

You can control your application icon mapping through the icon config file.

Analytics Script Injection

To inject your analytics tracking code into your page create a file named .analytics in the base project directory (the same folder as index.php) and place your analytics tracking script code into this file.

PreviousDockerNextConfiguration Reference

Last updated 1 month ago

Was this helpful?

See the for additional configuration options.

See the for more information about individual options.

Reference the for more information on configuring icons.

Directory Lister allows for including arbitrary analytics tracking script (e.g. from , , or any other analytics service) to be included in the HTML output of your directory listing.

App Config Reference
Configuration Reference
Google Analytics
Matomo Analytics
Umami Analytics
Icon Configuration