Configuration

Overview

All configurations can be set using environment variables or by providing a configuration file. If the same option is provided twice, the following priority is used:

• Environment Variable
• Configuration File
• Default Value

Configuration File

You can create a configuration file (json) to provide some options.

config.json

{
    "webServer": {
        "listen": "localhost:80"
    },
    "database": {
        "type": "postgres"
    }
}

Then provide the file name and path as an argument during Marty Media Server startup:

./marty-media-server server -config=config.json

Options

Database

Environment Variable	Configuration File Path	Default Value
MMS_DATABASE_TYPE	database.type	"postgres"
MMS_DATABASE_POSTGRES_ADDRESS	database.postgres.address	""
MMS_DATABASE_POSTGRES_PORT	database.postgres.port	5432
MMS_DATABASE_POSTGRES_USER	database.postgres.user	""
MMS_DATABASE_POSTGRES_PASSWORD	database.postgres.password	""
MMS_DATABASE_POSTGRES_DATABASE	database.postgres.database	""
MMS_DATABASE_POSTGRES_MAX_OPEN_CONNECTIONS	database.postgres.maxOpenConnections	8

Storage

Environment Variable	Configuration File Path	Default Value
MMS_STORAGE_TEMP_DIR	storage.tempDir	default temporary directory depending on the operating system
MMS_STORAGE_CACHE_SIZE	storage.cache.size	200000000 (200 GB)

WebServer

Marty Media Server starts on port 43200. So you can access the server using the following URL: http://localhost:43200

The following additional URLs are provided by the server:

• /web serves the UI / main frontend
• /api/v1 serves the API endpoint for all server actions
• /apidoc/v1/swagger/index.html serves the documentation for the API endpoint

Using HTTPS

Marty Media Server runs only on HTTP, but it's strongly recommended to expose the service only on HTTPS. You have multiple options (depending on your setup):

• Ingress Controller (e.g., Traefik or Nginx)
• WebServer with HTTPS as proxy (e.g., Nginx)