Configuration

Database: Stored at /app/data/mydb.sqlite .
Uploads: Stored at /app/data/uploads/ .
Outputs: Stored at /app/data/output/ .

ConvertX is configured primarily via Environment Variables passed to the Docker container.

Environment Variables

Variable	Default	Description
`JWT_SECRET`	`randomUUID()`	A secret string used to sign session tokens. Highly recommended to set this for persistence across restarts.
`ACCOUNT_REGISTRATION`	`false`	Set to `true` to allow users to register new accounts.
`ALLOW_UNAUTHENTICATED`	`false`	Set to `true` to allow usage without logging in (useful for local/private LAN use).
`HTTP_ALLOWED`	`false`	Set to `true` if you are running behind a proxy that handles SSL, or accessing via localhost HTTP.
`AUTO_DELETE_EVERY_N_HOURS`	`24`	Inteval in hours to delete old files. Set to `0` to disable auto-deletion.
`WEBROOT`	Empty	The URL path prefix if hosting in a subdirectory (e.g., `/convertx`).
`FFMPEG_ARGS`	Empty	Additional arguments to pass to FFmpeg (e.g., `-preset veryfast`).
`HIDE_HISTORY`	`false`	Set to `true` to remove the History tab from the navigation.
`LANGUAGE`	`en`	BCP 47 language tag used for formatting dates (e.g., `en`, `fr`, `zh`).
`UNAUTHENTICATED_USER_SHARING`	`false`	If `true` and unauthenticated access is allowed, all anonymous users share the same history/file list.
`MAX_CONVERT_PROCESS`	`0`	Limit concurrent conversions. `0` means unlimited.
`TZ`	`UTC`	Sets the container timezone (e.g., `Europe/Stockholm`).

The application requires a persistent volume mounted to /app/data.