Create Repository

Create Repository #

The amelie init <directory> [options] command is used to create a database repository.

Optional server options can be passed to the command. Options passed during repository creation will be saved in the configuration file, which will be created inside the directory: <directory>/config.json

amelie init ./repo

Server options can be changed directly by modifying the configuration file when the server is not running.

Some options can be changed dynamically using the SET command or passed to the amelie start.

Initial Configuration #

Several essential options can be passed directly to the amelie init command or changed after creating the repository.

The most notable options are:

Argument Type Description
uuid string Set server UUID. If not provided, it will be generated automatically.
timezone string Timezone to use. If not provided, the system timezone will be used.
frontends int The number of frontend workers. It will be set automatically based on the number of CPU cores if not provided.
backends int The number of pre-created backend workers. It will be set automatically based on the number of CPU cores if not provided.
listen array List of the addresses to accept connections. By default, it accepts all connections without authentication.

The listen option can be configured to accept connections from different network addresses, with or without authentication, with or without using the TLS certificates.

IO and Compute workers #

Options frontends, backends and using unlogged tables directly impact the performance.

The number of frontend workers can be changed at the server start, and the number of backend workers can be modified later using the CREATE BACKEND command.

Learn more about the IO and Compute processing.