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 | bashDocker Install
Run VillageSQL in a Docker container
docker run -d --name vsql -e MYSQL_ALLOW_EMPTY_PASSWORD=yes -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 rootBuild from Source
Clone the repository and build VillageSQL for your platform
git clone https://github.com/villagesql/villagesql-server.gitAgent Skills
Install Agent Skills
Claude Code, Codex, Cursor, Antigravity, and more
curl -sSL https://villagesql.com/skills | bash