> ## Documentation Index
> Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Install

> Install VillageSQL Server 0.0.7 built on Percona Server for MySQL 8.4.11

The Percona build ships alongside the MySQL 8.4 build. Install it with the
install script, Docker, or a source build.

**Install script, at a terminal.** Run the script, then choose **2) Percona 8.4**
at the first question:

```bash theme={null}
curl -fsSL https://install.villagesql.com | bash
```

**Install script, with no terminal.** In a CI job, a Dockerfile, or an AI agent,
name the codebase and the install method on the `bash` side of the pipe:

```bash theme={null}
curl -fsSL https://install.villagesql.com | \
  VSQL_CODEBASE=percona-8.4 INSTALL_METHOD=prebuilt bash
```

**Docker.** Images are published for each codebase and architecture:

```bash theme={null}
docker run -d --name vsql -e MYSQL_ROOT_PASSWORD=<your-password> -p 3306:3306 villagesql/server:percona-8.4_latest
```

**Source.** Follow [Build from Source](https://villagesql.com/docs/en/8.4/stable/source-percona.md).

A data directory belongs to the codebase that created it. VillageSQL refuses to
open a `mysql-8.4` data directory with a `percona-8.4` server, so install this
build into its own directory rather than pointing it at an existing one.

## Next Steps

To connect to the server and load your first extension, follow [Install](https://villagesql.com/docs/en/8.4/stable/install-server.md#step-2-connect-to-the-server) from step 2. The steps are the same on a Percona build.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.