Tokaido
Melbourne, Australia
What it is
Tokaido is a free, open-source tool for setting up local Drupal development environments using Docker and the `tok` command-line interface. Its containers can run PHP, Nginx, and MySQL, with optional services such as Solr, Memcache, Mailhog, and Adminer. The `tok up` command starts an environment and configures HTTPS for local development. Project settings can be stored in `.tok/config.yml` in the Git repository, allowing teammates to share the same configuration. An SSH endpoint provides access to tools such as Drush, Composer, Gulp, Yarn, and Npm. The tool includes security-header defaults, including X-Frame-Options, X-XSS-Protection, and Referrer-Policy. Tokaido supports macOS, Linux, and Windows and is built and primarily maintained by Ironstar. Its local environment is temporary: restarting resets the database, and files outside `/tokaido/site` are lost. Drupal multisite is supported, but `tok snapshot` and `tok test` do not account for multisite databases.
For and against
For
- Free and open source.
- Shares project settings through the Git repository.
- Starts local HTTPS environments with `tok up`.
- SSH endpoint includes common developer tools.
- Supports macOS, Linux, and Windows.
Against
- 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 commands.
The verdict
Tokaido provides a Docker-based local Drupal environment with shared project settings and an SSH-accessible toolset. Its temporary data behavior and documented Windows and multisite limitations are important to account for.
Who it suits
Tokaido suits developers creating local Drupal environments with Docker and teams that want to share project configuration through Git. Its Windows build is described as experimental, and Linux setup involves several dependencies and some manual steps.
Plans and prices
Tokaido
Open-source local Drupal development environment; runs with Docker
Read 8 Oct 2026 · tokaido.io
On the record
- Configuration
- Project settings can be stored in `.tok/config.yml` and shared with teammates through the Git repository.tokaido.io · read 8 Oct 2026
- Core stack
- Its environments run components such as PHP, Nginx, and MySQL in Docker containers.docs.tokaido.io · read 7 Oct 2026
- Data persistence
- The usage guide says the database survives `tok stop` and `tok up`, while destroying the environment also preserves the MySQL database.tokaido.io · read 8 Oct 2026
- Developer tools
- The environment includes an SSH endpoint for running tools such as Drush, Composer, and Gulp.docs.tokaido.io · read 7 Oct 2026
- Drupal multisite
- Drupal multisite is supported, but the documentation says `tok snapshot` and `tok test` are not aware of multisite databases.docs.tokaido.io · read 7 Oct 2026
- 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.tokaido.io · read 8 Oct 2026
- Linux setup
- Linux installation requires Docker, Docker Compose, Unison, ocaml, and fsmonitor, with some manual setup described.tokaido.io · read 8 Oct 2026
- Maintainer
- Tokaido is built and primarily maintained by Ironstar.docs.tokaido.io · read 7 Oct 2026
- Open source
- The maker describes Tokaido and its Docker containers as fully open source and says they can be forked and modified.tokaido.io · read 8 Oct 2026
- Optional services
- The configuration can enable services including Solr, Adminer, and Mailhog.tokaido.io · read 8 Oct 2026
- Other tools
- The SSH environment includes tools such as Drush, Yarn, and Npm.tokaido.io · read 8 Oct 2026
- Purpose
- Tokaido is a command-line tool and collection of Docker containers for running local Drupal development environments.tokaido.io · read 8 Oct 2026
- Security defaults
- The documentation says Tokaido sets security-related headers including HSTS, Referrer-Policy, and X-Frame-Options by default.tokaido.io · read 8 Oct 2026
- Startup
- A Drupal environment can be started from its Git repository with the `tok up` command.tokaido.io · read 8 Oct 2026
- Support
- The FAQ invites users to contact the maintainers when documentation does not resolve an issue.tokaido.io · read 8 Oct 2026
- Team configuration
- Tokaido stores shared settings in `.tok/config.yml` in the project Git repository so teammates can use the same configuration.docs.tokaido.io · read 7 Oct 2026
- Telemetry
- Telemetry is opt-in and can collect usage details such as Tokaido commands, enabled services, operating system, and project startup time.tokaido.io · read 8 Oct 2026
- Telemetry privacy
- The privacy policy says telemetry data is not sold or licensed and that IP addresses are not stored with Telemetry API data.tokaido.io · read 8 Oct 2026
