Command Line

When Kinto is installed, a command kinto becomes available.

It accepts a --ini parameter, whose default value is config/kinto.ini or the KINTO_INI env variable if defined.

A set of «sub commands» are available.

usage: kinto [-h] {init,start,migrate,version,rebuild-quotas} ...

Kinto Command-Line Interface

optional arguments:
  -h, --help            show this help message and exit

subcommands:
  Main Kinto CLI commands

  {init,start,migrate,version,rebuild-quotas}
                        Choose and run with --help

Configuration file

Creates a configuration file that works out of the box.

usage: kinto init [-h] [--backend BACKEND]

optional arguments:
  -h, --help         show this help message and exit
  --backend BACKEND  {memory,redis,postgresql}

Note

When choosing postgresql, the PostgreSQL Python dependencies will be installed if not available.

Database schemas

Installs the last database schemas in the configured backends.

usage: kinto migrate [-h] [--dry-run]

optional arguments:
  -h, --help  show this help message and exit
  --dry-run   Simulate the migration operations and show information

Note

Running this on PostgreSQL requires the configured user to have certain privileges (table creation etc.).

Local server

Starts Kinto locally using a simple HTTP server.

usage: kinto start [-h] [--reload] [--port PORT]

optional arguments:
  -h, --help   show this help message and exit
  --reload     Restart when code or config changes
  --port PORT  Listening port number

Note

This not recommended for production. See more details.

Rebuild quotas

Recalculate the amount of storage taken up by buckets and collections and update quota records to match reality. This can be useful if you’ve been bitten by bug #1226. However, this isn’t intended to be a reoccurring maintenance task – if your quota records are regularly becoming inaccurate, please file a bug!

usage: kinto rebuild-quotas [-h] [--ini INI_FILE] [-q] [-v] [--dry-run]

optional arguments:
  -h, --help      show this help message and exit
  --ini INI_FILE  Application configuration file
  -q, --quiet     Show only critical errors.
  -v, --debug     Show all messages, including debug messages.
  --dry-run       Simulate the rebuild operation and show information

For example:

kinto rebuild-quotas --ini=config/postgresql.ini

Flush Cache

Clears the content of the cache backend. This can be useful for debugging.

usage: kinto flush-cache [--ini INI_FILE]

For example:

kinto flush-cache --ini kinto.ini