All environment variables and settings for KohakuHub.
i-carbon-settings-adjust
Configuration Reference
KohakuHub can be configured via a config.toml file or by setting environment variables. Environment variables will always override values from a config.toml file.
By default, the application looks for config.toml in the current working directory. You can specify a different path using the HUB_CONFIG environment variable.
Application Settings
Variable
Description
Default
KOHAKU_HUB_BASE_URL
The base URL of the application, used for generating links.
http://localhost:48888
KOHAKU_HUB_API_BASE
The base path for the API.
/api
KOHAKU_HUB_SITE_NAME
The name of the site, displayed in the UI.
KohakuHub
KOHAKU_HUB_DEBUG_LOG_PAYLOADS
If true, logs request and response payloads for debugging.
false
Database Settings
Variable
Description
Default
KOHAKU_HUB_DB_BACKEND
The database backend to use. Can be sqlite or postgres.
sqlite
KOHAKU_HUB_DATABASE_URL
The connection URL for the database.
sqlite:///./hub.db
S3 Storage Settings
Variable
Description
Default
KOHAKU_HUB_S3_PUBLIC_ENDPOINT
The public-facing S3 endpoint, used for client downloads.
http://localhost:9000
KOHAKU_HUB_S3_ENDPOINT
The internal S3 endpoint for the application.
http://localhost:9000
KOHAKU_HUB_S3_ACCESS_KEY
The access key for the S3 bucket.
test-access-key
KOHAKU_HUB_S3_SECRET_KEY
The secret key for the S3 bucket.
test-secret-key
KOHAKU_HUB_S3_BUCKET
The name of the S3 bucket.
test-bucket
KOHAKU_HUB_S3_REGION
The S3 region.
us-east-1
KOHAKU_HUB_S3_SIGNATURE_VERSION
The S3 signature version (e.g., s3v4 for AWS S3/R2).
None
LakeFS Settings
Variable
Description
Default
KOHAKU_HUB_LAKEFS_ENDPOINT
The endpoint for the LakeFS server.
http://localhost:8000
KOHAKU_HUB_LAKEFS_ACCESS_KEY
The access key for LakeFS.
test-access-key
KOHAKU_HUB_LAKEFS_SECRET_KEY
The secret key for LakeFS.
test-secret-key
KOHAKU_HUB_LAKEFS_REPO_NAMESPACE
The default namespace for repositories in LakeFS.
hf
Git LFS Settings
Variable
Description
Default
KOHAKU_HUB_LFS_THRESHOLD_BYTES
The file size threshold in bytes to trigger LFS.
5242880 (5MB)
KOHAKU_HUB_LFS_MULTIPART_THRESHOLD_BYTES
The threshold for using multipart uploads for LFS.
104857600 (100MB)
KOHAKU_HUB_LFS_MULTIPART_CHUNK_SIZE_BYTES
The chunk size for LFS multipart uploads.
52428800 (50MB)
KOHAKU_HUB_LFS_KEEP_VERSIONS
The number of LFS file versions to keep during garbage collection.
5
KOHAKU_HUB_LFS_AUTO_GC
If true, automatically runs garbage collection on commits.
false
Authentication & Session Settings
Variable
Description
Default
KOHAKU_HUB_REQUIRE_EMAIL_VERIFICATION
If true, requires email verification for new users.
false
KOHAKU_HUB_INVITATION_ONLY
If true, disables public registration and requires an invitation.
false
KOHAKU_HUB_SESSION_SECRET
The secret key for session management. CHANGE IN PRODUCTION!
change-me-in-production
KOHAKU_HUB_SESSION_EXPIRE_HOURS
The session cookie expiration time in hours.
168 (7 days)
KOHAKU_HUB_TOKEN_EXPIRE_DAYS
The API token expiration time in days.
365
Admin API Settings
Variable
Description
Default
KOHAKU_HUB_ADMIN_ENABLED
If true, enables the admin API.
true
KOHAKU_HUB_ADMIN_SECRET_TOKEN
The secret token for accessing the admin API. CHANGE IN PRODUCTION!
change-me-in-production
Storage Quota Settings
Variable
Description
Default
KOHAKU_HUB_DEFAULT_USER_PRIVATE_QUOTA_BYTES
The default private repo quota for users in bytes.
None (unlimited)
KOHAKU_HUB_DEFAULT_USER_PUBLIC_QUOTA_BYTES
The default public repo quota for users in bytes.
None (unlimited)
KOHAKU_HUB_DEFAULT_ORG_PRIVATE_QUOTA_BYTES
The default private repo quota for organizations in bytes.
None (unlimited)
KOHAKU_HUB_DEFAULT_ORG_PUBLIC_QUOTA_BYTES
The default public repo quota for organizations in bytes.
None (unlimited)
Fallback Source Settings
Variable
Description
Default
KOHAKU_HUB_FALLBACK_ENABLED
If true, enables fallback to external sources.
true
KOHAKU_HUB_FALLBACK_CACHE_TTL
The cache TTL for fallback repo mappings in seconds.
300
KOHAKU_HUB_FALLBACK_TIMEOUT
The HTTP request timeout for external sources in seconds.
