Skip to main content


Download and run TimeBase Community Edition Installer. Follow a few simple steps to setup TimeBase Community Edition on your machine. You can also install TimeBase in Docker by following our Quick Start guide.


TimeBase Installer requires Java 11 or newer to be installed on your machine.

Step 1: Launch Installation

  1. Execute jar installation file to run TimeBase installation wizard.

  2. You can also launch TimeBase installation by running this command from the installation file root folder:

    java -jar installation-file-name.jar
  3. Click Next to proceed to the next step.

Step 2: Licensing

Accept the Apache open source license agreement to proceed with Community Edition installation.

Step 3: Installation

Select TimeBase installation folder to store all TimeBase system files.

Step 4: TimeBase Components

Along with TimeBase Server you can install a TimeBase Web Gateway and TimeBase Web Admin. Select Web Gateway to install both.

  • Web Admin - Web application for TimeBase administration. Refer to Admin Guide for details.
  • Web Gateway - REST/WS client for TimeBase Server. See API Reference

Step 5: Start TimeBase

Once TimeBase components are installed, you can start TimeBase Server.

  1. Specify Home folder. Home folder stores data, launching scripts, configs, logs of the running application. From a single installation folder it is possible to run multiple processes, each having a personal Home folder.
  2. Assign a free port for TimeBase.
  3. Start TimeBase (select one of the running options)
    • Run as service - TimeBase as a service is suitable for a continuous usage and on remote machines.
    • Run in terminal - runs in a console. Process ends as window closes. Suitable for local tests.
  4. Click Run TimeBase to start TimeBase.
  5. In case you run TimeBase as a service, you can click a Trash can icon to stop and uninstall this service.
  6. Click Next to proceed and launch TimeBase Web Admin or Finish to end installation on this step.

Successfully started TimeBase has status RUNNING.

When you click Run TimeBase, you get a ready-to-go sample data added to the Home folder that you have specified in this step. This is an example data and serves for demonstration purposes.

Step 6: Web Gateway Setup

In this step, TimeBase Installer allows you to launch a Web Gateway - REST/WS gateway for TimeBase Server. Web Gateway is also a TimeBase Web Admin, data management and monitoring Web application.

  1. Specify port for the Web Gateway. Displayed TimeBase port indicates on a specific TimeBase instance your Web Gateway will be working with (you may have multiple TimeBase instances running).
  2. Click Run Gateway to run application in terminal.
  3. Once application has started, you can click Open in browser to open TimeBase Web Admin application in browser. Web Admin displays streams with sample data from the Home folder (see previous step).
  4. Click Finish to end the installation process or Previous to return the the previous step.

What Is Next

TimeBase Shell

Use TimeBase TickDB Shell CLI to work with streams and run various maintenance and operational commands.

Launch tickdb.cmd from bin TimeBase folder to open TimeBase Shell. Run ? to get a list of available commands.

Solution Generator

Use TimeBase Solution Generator (Solgen) to generate ready-to-go code samples in several supported languages.



Refer to Client Libraries for more information.