The local cluster setup on a single host is intended for development and learning. For production deployment, performance benchmarking, or deploying a true multi-node on multi-host setup, see [Deploy YugabyteDB](/stable/deploy/).
## Install YugabyteDB
Installing YugabyteDB involves completing [prerequisites](#prerequisites) and [downloading the packaged database](#download).
### Prerequisites
{{% readfile "include-prerequisites-macos.md" %}}
#### Set file limits
Because each tablet maps to its own file, you can create a very large number of files in the current shell by experimenting with several hundred tables and several tablets per table. Execute the following command to ensure that the limit is set to a large number:
```sh
launchctl limit
```
It is recommended to have at least the following soft and hard limits:
```output
maxproc 2500 2500
maxfiles 1048576 1048576
```
Edit `/etc/sysctl.conf`, if it exists, to include the following:
```sh
kern.maxfiles=1048576
kern.maxproc=2500
kern.maxprocperuid=2500
kern.maxfilesperproc=1048576
```
If this file does not exist, create the following two files (this will require sudo access):
- `/Library/LaunchDaemons/limit.maxfiles.plist` and insert the following:
```xml
Label
limit.maxfiles
ProgramArguments
launchctl
limit
maxfiles
1048576
1048576
RunAtLoad
ServiceIPC
```
- `/Library/LaunchDaemons/limit.maxproc.plist` and insert the following:
```xml
Label
limit.maxproc
ProgramArguments
launchctl
limit
maxproc
2500
2500
RunAtLoad
ServiceIPC
```
Ensure that the `plist` files are owned by `root:wheel` and have permissions `-rw-r--r--`. To take effect, you need to reboot your computer or run the following commands:
```sh
sudo launchctl load -w /Library/LaunchDaemons/limit.maxfiles.plist
sudo launchctl load -w /Library/LaunchDaemons/limit.maxproc.plist
```
You might need to `unload` the service before loading it.
### Download
You download YugabyteDB as follows:
{{< tabpane text=true >}}
{{% tab header="macOS x86" lang="x86" %}}
1. Download the YugabyteDB `tar.gz` file by executing the following `wget` command:
```sh
wget https://software.yugabyte.com/releases/{{< yb-version version="stable">}}/yugabyte-{{< yb-version version="stable" format="build">}}-darwin-x86_64.tar.gz
echo "$(curl -L https://software.yugabyte.com/releases/{{< yb-version version="stable">}}/yugabyte-{{< yb-version version="stable" format="build">}}-darwin-x86_64-tar.gz.sha) *yugabyte-{{< yb-version version="stable" format="build">}}-darwin-x86_64.tar.gz" | shasum --check
```
1. Extract the package and then change directories to the YugabyteDB home, as follows:
```sh
tar xvfz yugabyte-{{< yb-version version="stable" format="build">}}-darwin-x86_64.tar.gz && cd yugabyte-{{< yb-version version="stable">}}/
```
{{% /tab %}}
{{% tab header="macOS ARM" lang="arm" %}}
1. Download the YugabyteDB `tar.gz` file by executing the following `wget` command:
```sh
wget https://software.yugabyte.com/releases/{{< yb-version version="stable">}}/yugabyte-{{< yb-version version="stable" format="build">}}-darwin-arm64.tar.gz
echo "$(curl -L https://software.yugabyte.com/releases/{{< yb-version version="stable">}}/yugabyte-{{< yb-version version="stable" format="build">}}-darwin-arm64-tar.gz.sha) *yugabyte-{{< yb-version version="stable" format="build">}}-darwin-arm64.tar.gz" | shasum --check
```
1. Extract the package and then change directories to the YugabyteDB home, as follows:
```sh
tar xvfz yugabyte-{{< yb-version version="stable" format="build">}}-darwin-arm64.tar.gz && cd yugabyte-{{< yb-version version="stable">}}/
```
{{% /tab %}}
{{< /tabpane >}}
## Create a local cluster
Use the [yugabyted](/stable/reference/configuration/yugabyted/) utility to create and manage universes.
{{< tabpane text=true >}}
{{% tab header="macOS Pre-Monterey" lang="Pre-Monterey" %}}
On macOS pre-Monterey, create a single-node local cluster with a replication factor (RF) of 1 by running the following command:
```sh
./bin/yugabyted start
```
{{% /tab %}}
{{% tab header="macOS Monterey" lang="Monterey" %}}
macOS Monterey enables AirPlay receiving by default, which listens on port 7000. This conflicts with YugabyteDB and causes `yugabyted start` to fail. Use the [--master_webserver_port flag](/stable/reference/configuration/yugabyted/#advanced-flags) when you start the cluster to change the default port number, as follows:
```sh
./bin/yugabyted start --master_webserver_port=9999
```
Alternatively, you can disable AirPlay receiving, then start YugabyteDB normally, and then, optionally, re-enable AirPlay receiving.
{{% /tab %}}
{{< /tabpane >}}
{{< readfile "/stable/quick-start/include-connect.md" >}}
## Build an application
Applications connect to and interact with YugabyteDB using API client libraries (also known as client drivers). This section shows how to connect applications to your cluster using your favorite programming language.
### Choose your language
Choose the language you want to use to build your application.
{{< readfile "/stable/quick-start-yugabytedb-managed/quick-start-buildapps-include.md" >}}
Use a cloud cluster
Use a local cluster