Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
126 lines (87 sloc) 4.36 KB

DolphinDB Single Node Deployment

Download DolphinDB from DolphinDB website and extract it to a directory. For example, extract it to the following directory:


1. Update License File

If you have obtained the Enterprise Edition license, please use it to replace the following file:


Otherwise, you can continue to use the community version of DolphinDB, which allows up to 4GB of memory use.

2. Run DolphinDB Server

Go to folder /DolphinDB/server/, and run dolphindb executable.

Linux console mode:


Linux background mode:

nohup ./dolphindb -console 0 &

In Linux, we recommend starting in the background mode with Linux command nohup (header) and & (tail). Even if the terminal is disconnected, DolphinDB will keep running. "-console" is set to 1 by default. To run in the background mode, we need to set it to 0 ("-console 0"). Otherwise, the system will quit after running for a while.

Windows: execute dolphindb.exe

The default port number of the system is 8848. To change it (to 8900), use the following command line:


./dolphindb -localSite localhost:8900:local8900


dolphindb.exe -localSite localhost:8900:local8900

The license file specifies the maximum amount of memory that DolphinDB can use. Users can lower the limit by specifying the configuration parameter -maxMemSize when starting DolphinDB.


./dolphindb -localSite localhost:8900:local8900 -maxMemSize 32


dolphindb.exe -localSite localhost:8900:local8900 -maxMemSize 32

3. Connect to DolphinDB Server from Web

Go to your web browser (currently supporting Chrome and Firefox) and enter localhost:8848 in the address bar to open DolphinDB notebook. If you have started DolphinDB server with another port number, change 8848 to the port number you have used.

4. Run DolphinDB Script from Web

Run the following DolphinDB script in the editor panel of DolphinDB notebook. The figure below shows the output.

date=take(2006.01.01..2006.01.31, n);
x=rand(10.0, n);
t=table(date, x);

db=database("dfs://valuedb", VALUE, 2006.01.01..2006.01.31)
pt = db.createPartitionedTable(t, `pt, `date);

select top 100 * from pt

the result

To use DolphinDB to work with huge volumes of data, we need to use partitioned database in DolphinDB. Regarding partitioned database please refer to DolphinDB Partitioned Database Tutorial.

Different from traditional databases, DolphinDB integrates database, programming language and distributed computing into one system. Table is one of the many data forms in DolphinDB. To use a table, we need to use function loadTable to assign the table to a variable. The variable name may be different from the table name.

select top 100 * from tmp

By default, database files are stored under the directory of

"DolphinDB package"/server/local8848

To change the directory we can specify the parameter 'volumes' in dolphindb.cfg.


  1. Starting from version 0.98, DolphinDB single node mode supports DFS databases.
  2. Please note that if the session in DolphinDB notebook is idle for 10 minutes, the session will be automatically closed to release resources on the server. We recommend users to work on DolphinDB GUI where all sessions remain open until terminated by users.

5. Change configuration

There are 2 ways to change single node mode configuration parameters:

  • update the configuration file dolphindb.cfg.

  • Specify configuration parameters in the command line when starting the node. For example, specify port number to be 8900 and the maximum memory to be 4GB:


./dolphindb -localSite localhost:8900:local8900 -maxMemSize 4


dolphindb.exe -localSite localhost:8900:local8900 -maxMemSize 4

For more information about DolphinDB configuration parameters please refer to Cluster Setup

6. Reference

For details about more configuration parameters, please refer to DolphinDB help.

You can’t perform that action at this time.