Freedom251 › Container Development Environments
Tokaido

What Tokaido is
Tokaido is an open-source tool for creating local Drupal development environments with Docker and its `tok` command line interface. Environments can run PHP, Nginx, and MySQL in containers, with optional services including Solr, Memcache, Mailhog, and Adminer. The `tok up` command starts an environment and configures HTTPS for local development. Shared project settings can be kept in `.tok/config.yml` in the Git repository so teammates can use the same configuration. An SSH endpoint provides access to tools such as Drush, Composer, Gulp, Yarn, and Npm. Tokaido is free and lists macOS, Linux, and Windows support. The maker says 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 Windows build is described as beta and experimental, and Windows users need the `winpty` prefix for `docker-compose exec`. Linux installation requires Docker, Docker Compose, Unison, ocaml, and fsmonitor, with some manual setup described.
Who it suits
Tokaido may suit Drupal developers who want a local Docker-based environment and shared project configuration. Windows users and teams using multisite databases should account for its stated limitations.
What it does well
- Runs Drupal components in Docker containers
- Can configure HTTPS with `tok up`
- Shares settings through the project Git repository
- Includes an SSH endpoint for developer tools
- Open source and free
What to know first
- Database resets when the environment restarts
- Files outside `/tokaido/site` are lost
- Windows build is beta and experimental
- Multisite snapshot and test commands lack database awareness
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| Tokaido | Open-source local Drupal development environment; runs with Docker | Free |
As tokaido.io lists them, read 8 Oct 2026. The maker's own page has the final word.
Getting started
- Visit https://tokaido.io/ and follow the installation guide for your platform.
- Prepare a Drupal 7 or Drupal 8 project with PHP 7.1 in a Git repository.
- Install the platform requirements: Docker-based components and, on Linux, Docker Compose, Unison, ocaml, and fsmonitor.
- Store shared project settings in `.tok/config.yml` if teammates need to use the same configuration.
- Run `tok up` to start the environment and set up HTTPS.
- On Windows, use the `winpty` prefix when running `docker-compose exec`.
Verdict
Tokaido offers a local Drupal setup with shared configuration and optional services. Its ephemeral data behavior and platform-specific setup requirements make it important to plan where files and databases live.
Questions
What does Tokaido cost?
The listed Tokaido plan costs nothing.
Is Tokaido open source?
Yes. Its maker describes Tokaido and its Docker containers as fully open source and says they can be forked and modified.
Which platforms does it support?
Tokaido lists Linux, macOS, and Windows. Its Windows build is described as beta and experimental.
Does it support Drupal multisite?
Yes, but the documentation says `tok snapshot` and `tok test` are not aware of multisite databases.
What happens to local data when the environment restarts?
The database resets, and files outside `/tokaido/site` are lost.
Who maintains Tokaido?
It is built and primarily maintained by Ironstar.
Facts from Tokaido's own pages
- Configuration
- Project settings can be stored in `.tok/config.yml` and shared with teammates through the Git repository. · tokaido.io, 8 Oct 2026
- Core stack
- Its environments run components such as PHP, Nginx, and MySQL in Docker containers. · docs.tokaido.io, 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, 8 Oct 2026
- Developer tools
- The environment includes an SSH endpoint for running tools such as Drush, Composer, and Gulp. · docs.tokaido.io, 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, 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, 8 Oct 2026
- Founded
- 2016 · tokaido.io, 28 Sept 2026
- Headquarters
- Melbourne, Australia · tokaido.io, 28 Sept 2026
- Linux setup
- Linux installation requires Docker, Docker Compose, Unison, ocaml, and fsmonitor, with some manual setup described. · tokaido.io, 8 Oct 2026
- Maintainer
- Tokaido is built and primarily maintained by Ironstar. · docs.tokaido.io, 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, 8 Oct 2026
- Optional services
- The configuration can enable services including Solr, Adminer, and Mailhog. · tokaido.io, 8 Oct 2026
- Other tools
- The SSH environment includes tools such as Drush, Yarn, and Npm. · tokaido.io, 8 Oct 2026
- Platforms
- The documentation provides installation instructions for macOS, Linux, and Windows; it describes the Windows build as experimental. · tokaido.io, 7 Oct 2026
- Purpose
- Tokaido is a command-line tool and collection of Docker containers for running local Drupal development environments. · tokaido.io, 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, 8 Oct 2026
- Startup
- A Drupal environment can be started from its Git repository with the `tok up` command. · tokaido.io, 8 Oct 2026
- Support
- The FAQ invites users to contact the maintainers when documentation does not resolve an issue. · tokaido.io, 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, 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, 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, 8 Oct 2026
- Windows limitation
- The Windows installation guide says running `docker-compose exec` requires the `winpty` prefix to address TTY compatibility. · docs.tokaido.io, 7 Oct 2026
- Windows status
- The Windows build is described as beta and experimental, and the guide lists Windows 10 Pro or Enterprise as a requirement. · tokaido.io, 8 Oct 2026
Where Tokaido stands on Freedom251
- Container Development Environments#31 of 40