Skip to content

Configuration

The Dracal device service uses a JSON configuration file that can be customized to meet your needs. Understanding and properly configuring this file can help resolve many common issues.

Configuration file location

%PROGRAMDATA%\Dracal\dracal-device-service-config.json

/etc/dracal/dracal-device-server-config.json

/Library/Application Support/Dracal/dracal-device-server-config.json

Common configuration settings

Changing the HTTP port

If port 11395 conflicts with another service or you need a different port: 

{
    "service": {
        "http": {
            "port": 11395
        }
    }
}

Change the port value to your desired port number (e.g., 8080, 12000). Remember to update your API calls to use the new port: http://localhost:<new_port>.

Restart required

You must restart the service after changing the port for the change to take effect.

Enabling debug logging

If you're troubleshooting issues, enable debug or trace logging: 

{
    "other": {
        "logs_enable_debug": true,
        "logs_enable_trace": false
    }
}

  • logs_enable_debug: Provides general troubleshooting information
  • logs_enable_trace: Provides the most detailed logging

Performance impact

Trace logging can generate very large log files and may impact performance. Only enable when actively troubleshooting, and disable it afterward.

Validating your configuration

After editing the configuration file:

  1. Check JSON syntax — ensure all brackets, braces, and commas are properly placed
  2. Restart the service — changes only take effect after restart
  3. Check logs — review log files for configuration errors
  4. Test the API — verify the service responds at the configured port

If the service fails to start after a configuration change, check the log files for error messages indicating the problem.