Subscribe to get updates

VillageSQL Server Installation

Instructions for how to install VillageSQL Server.

Need detailed instructions? Visit our complete documentation for step-by-step guides, configuration options, and troubleshooting.

Command Line Install

Quick installation using our install script

curl -fsSL https://install.villagesql.com | bash

Docker Install

Run VillageSQL in a Docker container

docker run -d --name vsql -e MYSQL_ROOT_PASSWORD=<your-password> \
  -p 3306:3306 villagesql/server:latest

The latest tag works on both Intel and Apple Silicon or ARM. For Percona Server or MySQL 9.7 instead of MySQL 8.4, use percona-8.4_latest or mysql-9.7_latest — see all published tags.

Then connect over TCP — use 127.0.0.1, not localhost (which looks for a Unix socket the container doesn't expose):

mysql -h 127.0.0.1 -P 3306 -u root -p

Build from Source

Clone the repository and build VillageSQL for your platform

git clone https://github.com/villagesql/villagesql-server.git

Agent Skills

Let your AI coding agent install VillageSQL, answer questions from the docs, and build or port extensions

Install Agent Skills

Works with Claude Code, Codex, Cursor, Antigravity, and more

curl -sSL https://villagesql.com/skills | bash