Skip to content
SPECIFICTION
Get listed

Tokaido

tokaido.io

Free plan WindowsmacOSLinux
Visit tokaido.io
Spec score 8.0 #17 of 40 in Container Development Environments

What it is

Tokaido is a free, open-source tool for creating local Drupal development environments with Docker and the `tok` command-line interface. Its containers can run PHP, Nginx, and MySQL, with optional services including Solr, Memcache, Mailhog, and Adminer. The `tok up` command starts an environment and sets up HTTPS. Project settings can be kept in `.tok/config.yml` in the Git repository, allowing teammates to share configuration. An SSH endpoint provides access to tools such as Drush, Composer, Gulp, Yarn, and Npm. Tokaido supports Linux, macOS, and Windows, though its Windows build is described as beta and experimental. Its local environment is ephemeral: the database resets on restart, and files outside `/tokaido/site` are lost. Drupal multisite is supported, but `tok snapshot` and `tok test` do not account for multisite databases. The project lists Drupal 7 or 8, PHP 7.1, and a Git repository as requirements. Tokaido was founded in 2016, is headquartered in Melbourne, and is primarily maintained by Ironstar.

Spec sheet

Purpose
Tokaido is a command-line tool and collection of Docker containers for running local Drupal development environments.Read 8 Oct 2026 · tokaido.io
Platforms
The documentation provides installation instructions for macOS, Linux, and Windows; it describes the Windows build as experimental.Read 7 Oct 2026 · tokaido.io
Support
The FAQ invites users to contact the maintainers when documentation does not resolve an issue.Read 8 Oct 2026 · tokaido.io
Headquarters
Melbourne, AustraliaRead 28 Sep 2026 · tokaido.io
Founded
2016Read 28 Sep 2026 · tokaido.io
Configuration
Project settings can be stored in `.tok/config.yml` and shared with teammates through the Git repository.Read 8 Oct 2026 · tokaido.io
Core stack
Its environments run components such as PHP, Nginx, and MySQL in Docker containers.Read 7 Oct 2026 · docs.tokaido.io
Data persistence
The usage guide says the database survives `tok stop` and `tok up`, while destroying the environment also preserves the MySQL database.Read 8 Oct 2026 · tokaido.io
Developer tools
The environment includes an SSH endpoint for running tools such as Drush, Composer, and Gulp.Read 7 Oct 2026 · docs.tokaido.io
Drupal multisite
Drupal multisite is supported, but the documentation says `tok snapshot` and `tok test` are not aware of multisite databases.Read 7 Oct 2026 · docs.tokaido.io
Drupal requirements
The installation guide lists Drupal 7 or Drupal 8, PHP 7.1, and a Git repository as requirements; it says unsupported project layouts may not receive support.Read 8 Oct 2026 · tokaido.io
Linux setup
Linux installation requires Docker, Docker Compose, Unison, ocaml, and fsmonitor, with some manual setup described.Read 8 Oct 2026 · tokaido.io
Maintainer
Tokaido is built and primarily maintained by Ironstar.Read 7 Oct 2026 · docs.tokaido.io
Open source
The maker describes Tokaido and its Docker containers as fully open source and says they can be forked and modified.Read 8 Oct 2026 · tokaido.io
Optional services
The configuration can enable services including Solr, Adminer, and Mailhog.Read 8 Oct 2026 · tokaido.io
Other tools
The SSH environment includes tools such as Drush, Yarn, and Npm.Read 8 Oct 2026 · tokaido.io
Security defaults
The documentation says Tokaido sets security-related headers including HSTS, Referrer-Policy, and X-Frame-Options by default.Read 8 Oct 2026 · tokaido.io
Startup
A Drupal environment can be started from its Git repository with the `tok up` command.Read 8 Oct 2026 · tokaido.io
Team configuration
Tokaido stores shared settings in `.tok/config.yml` in the project Git repository so teammates can use the same configuration.Read 7 Oct 2026 · docs.tokaido.io
Telemetry
Telemetry is opt-in and can collect usage details such as Tokaido commands, enabled services, operating system, and project startup time.Read 8 Oct 2026 · tokaido.io
Telemetry privacy
The privacy policy says telemetry data is not sold or licensed and that IP addresses are not stored with Telemetry API data.Read 8 Oct 2026 · tokaido.io
Windows limitation
The Windows installation guide says running `docker-compose exec` requires the `winpty` prefix to address TTY compatibility.Read 7 Oct 2026 · docs.tokaido.io
Windows status
The Windows build is described as beta and experimental, and the guide lists Windows 10 Pro or Enterprise as a requirement.Read 8 Oct 2026 · tokaido.io

Plans and prices

Tokaido Free Open-source local Drupal development environment; runs with Docker Read 8 Oct 2026 · tokaido.io

Every Tokaido plan and price →

Strong points and limits

Strong points

  • Free and open source
  • Shares project settings through Git
  • Starts local HTTPS with `tok up`
  • Includes an SSH endpoint with developer tools
  • Optional Solr, Memcache, Mailhog, and Adminer

Limits

  • Database resets when the environment restarts
  • Files outside `/tokaido/site` are lost
  • Windows build is beta and experimental
  • Multisite databases are not handled by snapshot and test

Who it suits

Tokaido suits developers who need a shared, Docker-based local environment for Drupal projects and prefer open-source tools. Windows users should be comfortable with an experimental build and its listed command-line workaround.

Verdict

Tokaido offers a free, configurable local Drupal environment with useful developer services and shared project settings. Its ephemeral storage and the stated Windows and multisite limitations deserve attention before adoption.

Where Specifiction places it

Alternatives to TokaidoAll alternatives →