How to use command line options

When Simple DNS Plus is running, you can use the following command line (DOS prompt) options:

(Make sure you run these from the directory where Simple DNS Plus is installed)

Backup

sdnsplus.exe -b <to-file>

Makes a backup of the live SQLite database used by Simple DNS Plus.

Can be used in scripts and schedulers to automate backups.

Clear cache

sdnsplus.exe -c

Removes all records from the cache.

Same as selecting "Clear Cache" from the main window / File menu.

Set remote password

sdnsplus.exe -m <password>

Enables remote management and sets the remote management password (see Options / Remote Management section).

This can be used to gain remote access to Simple DNS Plus - for example on a Server Core machine - see https://simpledns.plus/kb/119.

Start service

sdnsplus.exe -ss

Starts the Simple DNS Plus service (requires "run as administrator").

Shutdown

sdnsplus.exe -x

Shutdown Simple DNS Plus.

Load/re-load/update zone (DEPRECATED)

sdnsplus.exe -z  z:<zone-name> [f:<file-name>] [p:<primary-ip>] [g:<group-id>]

Loads, re-loads, and/or updates the status of a specific zone.

The f:file-name parameter is only required if this is a new zone. Specify the full path to the file, and make sure to use quotes if the path contains spaces ("f:C:\my dns data...")

The p:primary-ip parameter is only required if this is a secondary zone.

The g:group-id is optional and refers to the numerical zone group ID.

This option is deprecated and is available for backwards compatibility only. It will eventually be removed.
Use HTTP API functions instead. Note that the HTTP API can also be accessed from the command line or through batch scripting - for example using cURL (https://curl.haxx.se).

Unload/remove zone (DEPRECATED)

sdnsplus.exe -u  <zone-name>

Unloads / removes a zone.

This option is deprecated and is available for backwards compatibility only. It will eventually be removed.
Use HTTP API functions instead. Note that the HTTP API can also be accessed from the command line or through batch scripting - for example using cURL (https://curl.haxx.se).

 Comments
Gravatar
27 Mar 2020 21:52 UTC
Nathaniel Courtens
Is it possible to set DKIM TXT values using a command line? If yes, could I have an example? Thank you.
JH Software
12 Apr 2020 20:00 UTC
JH Software
You can set it by updating an entire zone through the command line (see -z option above) (deprecated) - or by updating individual records through the HTTP API (recommended).
Gravatar
29 Apr 2022 07:42 UTC
Radu Negrutiu
I receive an error message while trying to do backup in command line.
" *** ERROR: Error message received from service: unable to open database file"
Gravatar
2 May 2022 05:59 UTC
Radu Negrutiu
I receive an error message while trying to do backup in command line.
" *** ERROR: Error message received from service: unable to open database file"
(Never published. Used for replies and to show your Gravatar icon. Never used for any other purpose.)
Connect