> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-home-button.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Change the prompt in clickhouse-client

> This article explains how to change the prompt in your Clickhouse client and clickhouse-local terminal window from :) to a prefix followed by :)

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

If you don't like how `clickhouse client` and clickhouse-local display the prompt in your terminal window, it is possible to change it to add a prefix.
This article explains how to change the prompt to whatever you want.

The default prompt is your local computer name followed by `:) `:

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/0_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=69418df0c162478e8d90a7f14bdcb797" size="md" alt="Default ClickHouse client prompt" width="2289" height="411" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/0_prompt.png" />

The following are variables that you can use in a prompt: `{user}`, `{host}`

There are several ways to update the prompt and we'll go through them each.

<h2 id="--prompt-flag">
  \--prompt flag
</h2>

The first way to change the flag is using the `--prompt`:

```bash theme={null}
clickhouse --prompt 👉
```

This will add the finger emoji before the smiley face:

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/1_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=1d108cd7eca9384dfc64bc95101eea8f" size="md" alt="ClickHouse client prompt with finger emoji" width="2298" height="386" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/1_prompt.png" />

<h2 id="config-file---top-level">
  Config file - top level
</h2>

Alternatively, you can provide a prompt prefix in a `config.xml` file:

```xml theme={null}
<config>
    <prompt>👉 </prompt>
</config>
```

```
clickhouse
```

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/2_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=272ba890f4c9d69b575bc56fe5e6983b" size="md" alt="ClickHouse client prompt with config file" width="2307" height="769" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/2_prompt.png" />

We can use a config file with any name we like and pass it in using the `-C` flag:

```xml theme={null}
<config>
    <prompt>🎄 </prompt>
</config>
```

```
clickhouse -C christmas.xml
```

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/3_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=9cdbaa68ab412cef1df9f90f999467ce" size="md" alt="ClickHouse client prompt with Christmas tree emoji" width="2314" height="781" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/3_prompt.png" />

Prefer your config files to be in YAML?
That works too:

```yaml theme={null}
prompt: 🟡
```

```bash theme={null}
clickhouse -C christmas.yaml
```

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/4_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=90e4c818de8e668711d565d1fd302648" size="md" alt="ClickHouse client prompt with yellow circle emoji" width="2302" height="600" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/4_prompt.png" />

<h2 id="config-file---connections_credentials">
  Config file - connections\_credentials
</h2>

Alternatively, you can specify a prompt per connection credentials.
This only makes sense when using clickhouse-client.

```xml theme={null}
<config>
    <connections_credentials>
        <connection>
            <n>prod<n>
            <hostname>127.0.0.1</hostname>
            <port>9000</port>
            <secure>0</secure>
            <user>default</user>
            <prompt>\e[31m[PRODUCTION]\e[0m {user}@prod</prompt>
        </connection>
        <connection>
            <n>dev<n>
            <hostname>127.0.0.1</hostname>
            <port>9000</port>
            <secure>0</secure>
            <user>default</user>
            <prompt>\e[32m[DEVELOPMENT]\e[0m {user}@dev</prompt>
        </connection>
    </connections_credentials>
</config>
```

We can then try to connect with the `dev` connection:

```bash theme={null}
clickhouse client -C connections.xml --connection dev
```

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/5_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=8169ad22c36fddabd21081cb2f7aabfe" size="md" alt="ClickHouse client prompt with development connection" width="1310" height="203" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/5_prompt.png" />

Or the `prod` one:

```bash theme={null}
clickhouse client -C connections.xml --connection prod
```

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/6_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=275dc6dac3a20d200ceda899c62e033c" size="md" alt="ClickHouse client prompt with production connection" width="1297" height="189" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/6_prompt.png" />

And here's a YAML version:

```yaml theme={null}
connections_credentials:
  connection:
    - name: prod
      hostname: 127.0.0.1
      port: 9000
      secure: 0
      user: default
      prompt: "\e[35m[PRODUCTION]\e[0m {user}@{host}"
    - name: dev
      hostname: 127.0.0.1
      port: 9000
      secure: 0
      user: default
      prompt: "\e[34m[DEVELOPMENT]\e[0m {user}@{host}"
```

With the `dev` connnection:

```bash theme={null}
clickhouse client -C connections.yaml --connection dev
```

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/7_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=f61fd8a12630a91c70c5be31e33ac9e1" size="md" alt="ClickHouse client prompt with development connection using YAML" width="1581" height="169" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/7_prompt.png" />

And now `prod`:

```bash theme={null}
clickhouse client -C connections.yaml --connection prod
```

<Image img="https://mintcdn.com/private-7c7dfe99-home-button/f0mwoKzKU17GVzhc/images/knowledgebase/change-the-prompt-in-clickhouse-client/8_prompt.png?fit=max&auto=format&n=f0mwoKzKU17GVzhc&q=85&s=853e454d38e74e94d05ed33324d23bf3" size="md" alt="ClickHouse client prompt with production connection using YAML" width="1525" height="187" data-path="images/knowledgebase/change-the-prompt-in-clickhouse-client/8_prompt.png" />
