Core Settings
Fundamental server and database configuration.Port number for the HTTP server.
Hostname or IP address to bind the server to.
Secret key for session encryption and security. Must be at least 32 characters long.
Enable trust for proxy headers (X-Forwarded-For, X-Forwarded-Proto). Required when behind a reverse proxy.
Return HTTPS URLs instead of HTTP when generating file links.
Default domain to use for generating URLs. If not set, uses the request hostname.
Directory for temporary files during processing.
Database Configuration
PostgreSQL connection string. Required unless using individual database variables.
You can use either
DATABASE_URL or the individual database variables below. If both are provided, DATABASE_URL takes precedence.Database username (alternative to DATABASE_URL).
Database password (alternative to DATABASE_URL).
Database host (alternative to DATABASE_URL).
Database port (alternative to DATABASE_URL).
Database name (alternative to DATABASE_URL).
Datasource Configuration
Storage backend type. Options:
local, s3.Local Datasource
Directory path for storing uploaded files when using local datasource.
S3 Datasource
AWS access key ID or S3-compatible access key.
AWS secret access key or S3-compatible secret key.
AWS region for S3 bucket.
S3 bucket name for file storage.
Custom S3 endpoint for S3-compatible services (MinIO, DigitalOcean Spaces, etc.).
Use path-style URLs instead of virtual-hosted-style. Required for some S3-compatible services.
Subdirectory within the bucket to store files.
Chunked Uploads
Enable chunked/multipart uploads for large files.
Maximum size for chunked uploads.
Size of each chunk in multipart uploads.
Background Tasks
Interval settings for background maintenance tasks.All interval values use the
ms format: 30s, 5m, 1h, 1d, etc. Maximum value is 2147483647ms (~24.8 days).Interval for checking and deleting expired files.
Interval for clearing expired invites.
Interval for checking files that have reached maximum view count.
Interval for generating thumbnails for new uploads.
Interval for collecting and aggregating metrics.
Interval for cleaning up orphaned thumbnails.
File Upload Settings
URL route prefix for uploaded files.
Length of randomly generated file names.
Default naming format for uploaded files. Options:
random, date, uuid, name, gfycat, random-words.Comma-separated list of file extensions to block.
Maximum file size for uploads.
Default expiration time for uploaded files.
Maximum allowed expiration time users can set.
Assume MIME types from file extensions instead of detecting.
Date format for
date naming format.Automatically strip GPS metadata from uploaded images.
Number of adjectives in
random-words naming format.Separator character for
random-words naming format.Default image format for compression. Options:
jpg, png, webp.URL Shortener Settings
URL route prefix for shortened URLs.
Length of randomly generated short URL codes.
Feature Toggles
Enable image compression features.
Serve a robots.txt file.
Enable the
/api/healthcheck endpoint.Allow new user registration.
Allow registration via OAuth providers.
Automatically delete files when they reach maximum view count.
Check for new Zipline versions.
API endpoint for version checking.
Thumbnail Settings
Enable automatic thumbnail generation.
Number of worker threads for thumbnail generation.
Output format for thumbnails. Options:
jpg, png, webp.Metrics Settings
Enable metrics collection and analytics.
Restrict metrics viewing to administrators only.
Show user-specific metrics to individual users.
Domain Configuration
Comma-separated list of additional domains for multi-domain support.
Invite System
Enable the invite system for user registration.
Length of generated invite codes.
Next Steps
Datasource Configuration
Detailed S3 and local storage setup
Authentication
OAuth providers and MFA configuration