example.env

# App environment: production or development
MTSU_ENV=production
# Log level: debug, info, warn, error
MTSU_LOG_LEVEL=info

# Credentials for the initial admin user. Recommended to change.
MTSU_INITIAL_ADMIN_NAME=admin
MTSU_INITIAL_ADMIN_PW=admin321

# Hostname and port for the server. Use mtsuserver as the hostname if using Docker Compose.
MTSU_HOSTNAME=localhost
MTSU_PORT=5050

# Domain for the server. Used in cookies.
# For example, if the address for the server is "api.example.org", and for the frontend "read.example.org",
# the value here should be "example.org" for the cookies to work properly between subdomains.
# https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#define_where_cookies_are_sent
MTSU_DOMAIN=localhost

# When true, the server only allows authenticated connections from the MTSU_DOMAIN and its subdomains (eg .*.example.org).
# When false, connections from every origin is allowed.
# https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Access-Control-Allow-Origin
MTSU_STRICT_ACAO=false

# When true, Mangatsu can be accessed only through HTTPS or localhost domains.
MTSU_SECURE=true

# Paths to the archive directories. Relative or absolute paths are accepted.
# First specify the type of the directory and a numerical ID (e.g. freeform1 or structured2) and then the path separated by a semicolon: `;`.
# Multiple paths can be separated by a double-semicolon: `;;`.
# Format: `<freeform|structured><ID>;<INTERNAL_PATH>;;<freeform|structured><ID>;<INTERNAL_PATH>`...
# If using Docker Compose, make sure that the paths match the containerpaths in the volumes section.
MTSU_BASE_PATHS=freeform1;/home/user/doujinshi;;structured2;/home/user/manga

# Location of the data dir which includes the SQLite db and the cache for gallery images and thumbnails. Relative or absolute paths are accepted.
# Doesn't need changing if using Docker Compose.
MTSU_DATA_PATH=../data

# Database
MTSU_DB_NAME=mangatsu # The filename (without extension) of the SQLite.
MTSU_DB_MIGRATIONS=true # For development. Keep as true.

# Set true to disable the internal cache server (serves media files and thumbnails). Useful if one wants to use the web server such as NGINX to serve the files.
MTSU_DISABLE_CACHE_SERVER=false

# Cache time to live (for example 336h (2 weeks), 8h30m). If a gallery is not viewed for this time, it will be purged from the cache.
MTSU_CACHE_TTL=336h

# public: anyone can access the collection and its galleries.
# restricted: users need a global passphrase to access collection and its galleries.
# private: only logged-in users can access the collection and its galleries.
# In all modes, user accounts are supported and have more privileges than anonymous users (e.g. favorite galleries).
MTSU_VISIBILITY=public

# Passphrase to access the collection and its galleries.
# Only used when VISIBILITY is set to restricted.
MTSU_RESTRICTED_PASSPHRASE=secretpassword

# Whether to allow user registrations. If set to false, only admins can create new users.
# Currently, only affects the API path /register. Has no effect in the frontend.
MTSU_REGISTRATIONS=false

# Secret to sign JWTs for login sessions in the backend. Recommended to change.
MTSU_JWT_SECRET=9Wag7sMvKl3aF6K5lwIg6TI42ia2f6BstZAVrdJIq8Mp38lnl7UzQMC1qjKyZCBzHFGbbqsA0gKcHqDuyXQAhWoJ0lcx4K5q

# Thumbnail image format: webp
# AVIF support is planned. AVIF is said to take 20% longer to encode, but it compresses to 20% smaller size compared to WebP.
MTSU_THUMBNAIL_FORMAT=webp

# Similarity threshold for the fuzzy match for gallery and metadata filenames.
# The higher the value, the more similar the results has to be to match. 0.1 - 1.0.
MTSU_FUZZY_SEARCH_SIMILARITY=0.7

# Set to false to use right-to-left (RTL) default for galleries. Otherwise, defaults to left-to-right (like Japanese manga).
MTSU_LTR=true