Quick install

[Edit this page](https://github.com/ClickHouse/clickhouse-docs/blob/main/docs/getting-started/install/quick-install.md)

If you don't need to install ClickHouse for production, the quickest way to get
set up is using the ClickHouse CLI or running an install script using curl.

- ClickHouse CLI- Curl script

The ClickHouse CLI (`clickhousectl`) helps you install and manage local ClickHouse
versions, launch servers, and run queries.

Install the ClickHouse CLI

## Install the ClickHouse CLI[​](#install-the-cli "Direct link to Install the ClickHouse CLI")

```
curl https://clickhouse.com/cli | sh
```

A `chctl` alias is also created automatically for convenience.

Install ClickHouse

## Install ClickHouse[​](#install-clickhouse "Direct link to Install ClickHouse")

```
clickhousectl local install stable
```

Start clickhouse-server

## Start clickhouse-server[​](#start-clickhouse-server "Direct link to Start clickhouse-server")

```
clickhousectl local server start
```

The server runs in the background. To verify it's running:

```
clickhousectl local server list
```

Start clickhouse-client

## Start clickhouse-client[​](#start-clickhouse-client "Direct link to Start clickhouse-client")

```
clickhousectl local client
```

You will see something like this:

```
ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.

local-host :)
```

You're now ready to start sending SQL commands to ClickHouse!

Tip

The [Quick Start](/docs/get-started/quick-start) walks you through the steps for creating tables and inserting data.

If you don't need to install ClickHouse for production, you can run an install script using curl. The script will determine a suitable binary for your OS.

Install ClickHouse using curl

## Install ClickHouse using curl[​](#install-clickhouse-using-curl "Direct link to Install ClickHouse using curl")

Run the following comand to download a single binary for your operating system.

```
curl https://clickhouse.com/ | sh
```

Note

For Mac users: If you're getting errors that the developer of the binary can't be verified, please see [here](/docs/knowledgebase/fix-developer-verification-error-in-macos).

Start clickhouse-local

## Start clickhouse-local[​](#start-clickhouse-local "Direct link to Start clickhouse-local")

`clickhouse-local` allows you to process local and remote files using ClickHouse's
powerful SQL syntax and without the need for configuration. Table data is stored
in a temporary location, meaning that after a restart of `clickhouse-local`
previously created tables are no longer available.

Run the following command to start [clickhouse-local](/docs/operations/utilities/clickhouse-local):

```
./clickhouse
```

Start clickhouse-server

## Start clickhouse-server[​](#start-clickhouse-server "Direct link to Start clickhouse-server")

Should you wish to persist data, you'll want to run `clickhouse-server`. You can
start the ClickHouse server using the following command:

```
./clickhouse server
```

Start clickhouse-client

## Start clickhouse-client[​](#start-clickhouse-client "Direct link to Start clickhouse-client")

With the server up and running, open a new terminal window and run the following command
to launch `clickhouse-client`:

```
./clickhouse client
```

You will see something like this:

```
./clickhouse client
ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.

local-host :)
```

Table data is stored in the current directory and will still be available after a restart
of the ClickHouse server. If necessary, you can pass
`-C config.xml` as an additional command line argument to `./clickhouse server`
and provide further configuration in a configuration
file. All available configuration settings are documented [here](/docs/operations/server-configuration-parameters/settings) and in the
[example configuration file
template](https://github.com/ClickHouse/ClickHouse/blob/master/programs/server/config.xml).

You're now ready to start sending SQL commands to ClickHouse!

Tip

The [Quick Start](/docs/get-started/quick-start) walks you through the steps for creating tables and inserting data.

- [Install the ClickHouse CLI](#install-the-cli)- [Install ClickHouse](#install-clickhouse)- [Start clickhouse-server](#start-clickhouse-server)- [Start clickhouse-client](#start-clickhouse-client)- [Install ClickHouse using curl](#install-clickhouse-using-curl)- [Start clickhouse-local](#start-clickhouse-local)- [Start clickhouse-server](#start-clickhouse-server)- [Start clickhouse-client](#start-clickhouse-client)

Was this page helpful?