.env.example

# The application reads the environment only; This file is for easy configuration only.

# Path to the SQLite database file.
KITTYSHARE_DATABASE_PATH=/database.sqlite

# Root directory the admin file picker may browse and share from.
KITTYSHARE_ROOT=/data/files

# Session lifetime in seconds (default: 2592000 = 30 days).
KITTYSHARE_SESSION_LIFETIME=2592000

# Session cookie SameSite policy: Lax, Strict or None (default: Lax).
# None requires Secure.
KITTYSHARE_COOKIE_SAMESITE=Lax

# Session cookie Secure flag: 1/true/yes/on or 0/false/no/off.
# When unset, it follows whether the request uses HTTPS.
KITTYSHARE_COOKIE_SECURE=false

# List dotfiles in share and picker listings: true to show (default: hidden).
KITTYSHARE_SHOW_DOTFILES=false

# Canonical base URL used for absolute share links (default: relative links).
KITTYSHARE_BASE_URL=https://files.example.com

# Number of bytes sent per chunk when downloading files (default: 8192).
# Only used by the default PHP file server (KITTYSHARE_FILE_SERVER=php).
KITTYSHARE_DOWNLOAD_CHUNK_SIZE=8192

# File server backend: php or x-sendfile (default: php).
# - php: streams files through PHP, works everywhere.
# - x-sendfile (alias: apache): PHP authorizes the request, Apache sends
#   the file via mod_xsendfile. Requires XSendFile On + XSendFilePath in
#   the Apache vhost (see apache-vhost.conf).
KITTYSHARE_FILE_SERVER=php

# Generic meta description text (default: omitted).
# When set, it is used for <meta name="description"> and og:description on all pages.
# KITTYSHARE_META_DESCRIPTION=KittyShare: self-hosted private file sharing.

# Open Graph extensiveness: none, minimal or per-share (default: none).
# - none: no og:* tags
# - minimal: only generic site tags (og:site_name, og:type, og:title="KittyShare").
# - per-share: additionally og:title with the shared folder/file name on share pages.
KITTYSHARE_META_OG_MODE=none