Command-line tool

Installing tiled adds a command-line tool, tiled, to the environment. Use tiled --help for info, or see the documentation below.

tiled

tiled [OPTIONS] COMMAND [ARGS]...

Options

--install-completion <install_completion>

Install completion for the specified shell.

Options:

bash | zsh | fish | powershell | pwsh

--show-completion <show_completion>

Show completion for the specified shell, to copy it or customize the installation.

Options:

bash | zsh | fish | powershell | pwsh

admin

Administrative utilities for managing large deployments.

tiled admin [OPTIONS] COMMAND [ARGS]...

check-config

Check configuration file for syntax and validation errors.

tiled admin check-config [OPTIONS] [CONFIG_PATH]

Arguments

CONFIG_PATH

Optional argument

downgrade-database

Upgrade the database schema to the latest version.

tiled admin downgrade-database [OPTIONS] DATABASE_URI REVISION

Arguments

DATABASE_URI

Required argument

REVISION

Required argument

initialize-database

Initialize a SQL database for use by Tiled.

tiled admin initialize-database [OPTIONS] DATABASE_URI

Arguments

DATABASE_URI

Required argument

list-principals

List information about all Principals (users or services) that have ever logged in.

tiled admin list-principals [OPTIONS] [PAGE_OFFSET] [PAGE_LIMIT]

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

Arguments

PAGE_OFFSET

Optional argument

PAGE_LIMIT

Optional argument

show-principal

Show information about one Principal (user or service).

tiled admin show-principal [OPTIONS] UUID

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

Arguments

UUID

Required argument

upgrade-database

Upgrade the database schema to the latest version.

tiled admin upgrade-database [OPTIONS] DATABASE_URI [REVISION]

Arguments

DATABASE_URI

Required argument

REVISION

Optional argument

api_key

Create, list, and revoke API keys.

tiled api_key [OPTIONS] COMMAND [ARGS]...

create

tiled api_key create [OPTIONS]

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

--expires-in <expires_in>

Number of seconds until API key expires. If None, it will never expire or it will have the maximum lifetime allowed by the server.

--scopes <scopes>

Restrict the access available to this API key by listing scopes. By default, it will inherit the scopes of its owner.

--note <note>

Add a note to label this API key.

--no-verify

Skip SSL verification.

Default:

False

list

tiled api_key list [OPTIONS]

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

revoke

tiled api_key revoke [OPTIONS] FIRST_EIGHT

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

Arguments

FIRST_EIGHT

Required argument

connect

“Connect” to a Tiled server; set it as default.

tiled connect [OPTIONS] URI_OR_PROFILE

Options

--no-verify

Skip SSL verification.

Default:

False

Arguments

URI_OR_PROFILE

Required argument

disconnect

“Disconnect” from the default Tiled server.

tiled disconnect [OPTIONS]

download

Download content from a Tree to an on-disk cache.

tiled download [OPTIONS] CACHE_PATH [CAPACITY]

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

Arguments

CACHE_PATH

Required argument

CAPACITY

Optional argument

login

Log in to an authenticated Tiled server.

tiled login [OPTIONS]

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

--show-secret-tokens

Show secret tokens after successful login.

Default:

False

logout

Log out from one or all authenticated Tiled servers.

tiled logout [OPTIONS]

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

profile

Examine Tiled ‘profiles’ (client-side config).

tiled profile [OPTIONS] COMMAND [ARGS]...

list

List the profiles (client-side configuration) found and the files they were read from.

tiled profile list [OPTIONS]

paths

List the locations that the client will search for profiles (client-side configuration).

tiled profile paths [OPTIONS]

show

Show the content of a profile.

tiled profile show [OPTIONS] PROFILE_NAME

Arguments

PROFILE_NAME

Required argument

serve

Launch a Tiled server.

tiled serve [OPTIONS] COMMAND [ARGS]...

config

Serve a Tree as specified in configuration file(s).

tiled serve config [OPTIONS] [CONFIG_PATH]

Options

--public

Turns off requirement for API key authentication for reading. However, the API key is still required for writing, so data cannot be modified even with this option selected.

Default:

False

--host <host>

Bind socket to this host. Use –host 0.0.0.0 to make the application available on your local network. IPv6 addresses are supported, for example: –host ‘::’. Uses value in config by default.

--port <port>

Bind to a socket with this port. Uses value in config by default.

--scalable

This verifies that the configuration is compatible with scaled (multi-process) deployments.

Default:

False

Arguments

CONFIG_PATH

Optional argument

demo

Start a public server with example data.

tiled serve demo [OPTIONS]

Options

--host <host>

Bind socket to this host. Use –host 0.0.0.0 to make the application available on your local network. IPv6 addresses are supported, for example: –host ‘::’.

Default:

127.0.0.1

--port <port>

Bind to a socket with this port.

Default:

8000

directory

Serve a Tree instance from a directory of files.

tiled serve directory [OPTIONS] DIRECTORY

Options

--public

Turns off requirement for API key authentication for reading. However, the API key is still required for writing, so data cannot be modified even with this option selected.

Default:

False

--keep-ext

Serve a file like ‘measurements.csv’ as its full filepath with extension, instead of the default which would serve it as ‘measurements’. This is discouraged because it leaks details about the storage format to the client, such that changing the storage in the future may break user (client-side) code.

Default:

False

--poll-interval <poll_interval>

Time in seconds between scans of the directory for removed or changed files. If 0, do not poll for changes.

--host <host>

Bind socket to this host. Use –host 0.0.0.0 to make the application available on your local network. IPv6 addresses are supported, for example: –host ‘::’.

Default:

127.0.0.1

--port <port>

Bind to a socket with this port.

Default:

8000

--data-cache <object_cache_available_bytes>

Maximum size for the object cache, given as a number of bytes as in 1_000_000 or as a fraction of system RAM (total physical memory) as in 0.3. Set to 0 to disable this cache. By default, it will use up to 0.15 (15%) of RAM.

--scalable

This verifies that the configuration is compatible with scaled (multi-process) deployments.

Default:

False

Arguments

DIRECTORY

Required argument

pyobject

Serve a Tree instance from a Python module.

tiled serve pyobject [OPTIONS] OBJECT_PATH

Options

--public

Turns off requirement for API key authentication for reading. However, the API key is still required for writing, so data cannot be modified even with this option selected.

Default:

False

--host <host>

Bind socket to this host. Use –host 0.0.0.0 to make the application available on your local network. IPv6 addresses are supported, for example: –host ‘::’.

Default:

127.0.0.1

--port <port>

Bind to a socket with this port.

Default:

8000

--data-cache <object_cache_available_bytes>

Maximum size for the object cache, given as a number of bytes as in 1_000_000 or as a fraction of system RAM (total physical memory) as in 0.3. Set to 0 to disable this cache. By default, it will use up to 0.15 (15%) of RAM.

--scalable

This verifies that the configuration is compatible with scaled (multi-process) deployments.

Default:

False

Arguments

OBJECT_PATH

Required argument

status

Show the current default Tiled server.

tiled status [OPTIONS]

tree

Show the names of entries in a Tree.

This is similar to the UNIX utility tree for listing nested directories.

tiled tree [OPTIONS] [MAX_LINES]

Options

--profile <profile>

If you use more than one Tiled server, use this to specify which.

Arguments

MAX_LINES

Optional argument