Appearance
ts config
Show and change the ts client's own settings: which server commands go to by default, and which servers you are signed in to.
Usage
text
ts config
ts config --server=<url> [--no-verify]
ts config --resetDescription
ts config prints the server the next command would go to and every server you are signed in to.
ts config --server=<url> makes <url> the default server, so later commands need no --server flag. A bare host name is taken as https://. Before storing it, ts checks that the address answers as a Turbo Server; --no-verify stores it without checking, for a server that is not up yet. ts login --server=<url> also sets the default, when none is set.
ts config --reset clears the stored settings, including the default server. Your sign-ins are kept.
These settings belong to ts on this machine and this account; they change nothing on any server. The stored default is the lowest-priority way to pick a server: the TSSERVER environment variable wins over it, and a --server flag on a command wins over both. A bare host in either one that matches a server you signed in to takes that sign-in's full address, scheme and port included.
Options
| Flag | Description | Default/Values | Notes |
|---|---|---|---|
--server | The server to store as the default. | URL or host name | The global option, read here as the value to store. |
--no-verify | Store the server without checking that it answers. | With --server. | |
--reset | Reset the settings to their defaults. | Leaves sign-ins in place. |
Examples
bash
# What am I pointed at, and where am I signed in?
ts config
# Point at a server by default
ts config --server=https://turbo.example.net
# Store a server that is not reachable yet
ts config --server=https://turbo.example.net --no-verify
# Override for one command
ts --server=https://staging.example.net workspaces
# Override for a whole shell session
export TSSERVER=https://staging.example.net
ts workspacesOutput
text
Server: https://turbo.example.net
Signed in: [email protected], [email protected]When TSSERVER is set, a second line under Server: says so.
Files
| File | Contents |
|---|---|
settings.json | The default server. |
credentials.json | Stored sign-ins, one per server. Readable only by you. |
Both are in %LOCALAPPDATA%\Turbo Server\cli on Windows and in $XDG_CONFIG_HOME/turbo-server (usually ~/.config/turbo-server) elsewhere. TSCONFIGDIR names another directory.
Exit Codes
0 on success. -1 when the value given to --server is not a usable http or https address. -3 when the server cannot be verified; pass --no-verify to store it anyway.