Documentation
DocumentationDiscussions
These docs are for v2020.1. Click to read the latest docs for v2024.2.

Server Command Line

The seq.exe executable (Windows) and datalust/seq container (Docker) have an extensive command line for performing administration tasks.

Seq Server Command-Line

Usage

Syntax (Windows):

seq <command> [<args>]

Syntax (Docker):

docker run --rm -it -v $HOST_PATH_TO_SEQ:/data datalust/seq <command> [<args>]

Available commands are:

CommandDescription
auth Change authentication provider
backup Write a backup of the Seq configuration and metadata
bind-ssl Bind an installed SSL certificate to an HTTPS port served by Seq
browse Open a web browser on the Seq user interface
config clear Clear fields in the Seq.json file
config create Create a default Seq.json file, if none exists
config get View a field from the Seq.json file
config hash Read a password from STDIN and print a salted, base-64 encoded cryptographic hash of the password that is suitable for storing in configuration fields. Leading and trailing whitespace will be trimmed.
config list View all fields in the Seq.json file
config set Set a field in the Seq.json file
help Show information about available commands
metastore to-mssql Reconfigure and move the internal metastore to a Microsoft SQL Server/Azure SQL database
restore Restore from a backup of the Seq configuration and metadata
run Run the server process
service install Install the Seq server as a Windows service
service list List Seq Windows services installed on the machine
service restart Restart the Seq Windows service
service start Start the Seq server as a Windows service
service status Show the status of the Seq Windows service
service stop Stop the Seq Windows service
service uninstall Uninstall the Seq Windows service
show-key Print the master encryption key used to protect sensitive fields and backup files
version Print the current executable version

Type seq help <command> for detailed help.

Commands

auth

Change authentication provider.

OptionDescription
--basicSwitch to basic username/password authentication; must be specified in conjunction with name and new credentials for an administrative account
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-p, --password=VALUEThe password for the user account
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.
-u, --username=VALUEThe name of the user account

backup

Write a backup of the Seq configuration and metadata.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-p, --path=VALUEThe folder path where the backup file should be stored (default: current directory)
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

bind-ssl

Bind an installed SSL certificate to an HTTPS port served by Seq. Windows only.

OptionDescription
--hostname=VALUEIf SNI is used, the specific host name to bind to (default is to bind to all hostnames via the IP address)
--port=VALUEThe port on which the Seq server is listening (default is 443)
--thumbprint=VALUEThe thumbprint of the SSL certificate to bind; this can be found with the Manage computer certificates program

browse

Open a web browser on the Seq user interface.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

config clear

Clear fields in the Seq.json file.

OptionDescription
-k, --key=VALUEThe field, for example api.listenUris
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

config create

Create a default Seq.json file, if none exists.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

config get

View a field from the Seq.json file.

OptionDescription
-k, --key=VALUEThe field, for example api.listenUris
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

config hash

Read a password from STDIN and print a salted, base-64 encoded cryptographic hash of the password that is suitable for storing in configuration fields. Leading and trailing whitespace will be trimmed..

config list

View all fields in the Seq.json file.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

config set

Set a field in the Seq.json file.

OptionDescription
-k, --key=VALUEThe field, for example api.listenUris
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.
-v, --value=VALUEThe field value, comma-separated if multiple values are accepted

help

Show information about available commands.

Example:

seq seq help search

metastore to-mssql

Reconfigure and move the internal metastore to a Microsoft SQL Server/Azure SQL database.

OptionDescription
-c, --connection-string=VALUEThe connection string for the target database
--msi-resource=VALUEIf the connection must use an Azure Managed Service Identity, the resource for which to request an access token; normally this will be https://database.windows.net/; the default is to not use an Azure MSI
--msi-tenant-id=VALUEIf using an Azure Managed Service Identity and the identity has access to multiple tenants, the tenant id; the default is to not specify a tenant id
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.
--schema=VALUEThe schema under which to store metadata; the default is dbo
--skip-configDon't save the connection string and schema to the Seq.config file (useful if the connection string will be supplied in an environment variable once the metastore is moved)

restore

Restore from a backup of the Seq configuration and metadata.

OptionDescription
-b, --backup=VALUEThe .seqbac file to restore from; this must have been created with the exact Seq version in use
--confirmAssume y for any confirmations
--enable-appsEnable streaming events to plug-in Seq apps; by default, apps must be manually re-enabled after restoring
-k, --master-key=VALUEThe base-64 encoded master encryption key (enclose in double quotes to escape embedded equals signs)
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

run

Host the server in the current process.

OptionDescription
--default-admin-password-stdinRead a default password for the first administrator account from STDIN; the password will be requested, but ignored, after the first time Seq is run
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
--nologo
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

service install

Install the Seq server as a Windows service. Windows only.

OptionDescription
-l, --listen=VALUESet the URL(s) to listen on; the default is 'http://localhost:5341'
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-p, --password=VALUEThe password for the Windows account to run the service under
--ram-target=VALUESets the system memory consumption target that Seq will use to determine utilization, in percent. The default is 90.
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.
--setupInstall and start the service only if it does not exist; otherwise reconfigure the binary location
-u, --username=VALUEThe name of a Windows account to run the service under; if not specified the Local System account will be used

service list

List Seq Windows services installed on the machine. Windows only.

service restart

Restart the Seq Windows service. Windows only.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance

service start

Start the Seq server as a Windows service. Windows only.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance

service status

Show the status of the Seq Windows service. Windows only.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance

service stop

Stop the Seq Windows service. Windows only.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance

service uninstall

Uninstall the Seq Windows service. Windows only.

OptionDescription
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance

show-key

Print the master encryption key used to protect sensitive fields and backup files.

OptionDescription
--generateGenerate and print a new key to use with another Seq instance
-n, --name=VALUEIf multiple Seq instances are in use, the name of the instance
-s, --storage=VALUESpecify the folder where data for this instance is stored; C:\ProgramData\Seq(\Instance[Name]) is used by default.

version

Print the current executable version.