Multidev FAQ

A quick reference to answer some of the most frequently asked questions about Multidev.

Discuss in our Forum Discuss in Slack

For information about what Multidev is and how to use it, see our full guide on Multidev.

Who has access to Multidev?

Multidev is available to all organizations and users with Gold Accounts and above, as well as their supporting partners and agencies.

Should I have access to Multidev?

Multidevs that are already on a site are available to all users with access to the site.

Users have access to create a new Multidev if they:

  • Belong to a Gold Account customer or above.
  • Support a site that is owned by a Gold Account customer or above.

Multidev environments that are already created on a Pantheon site are available to all users with access to the site.

Visit the Partner Program page to learn more about the benefits of becoming a Pantheon Partner Agency, or contact us.

If you meet the conditions and still don't have access to an existing Multidev or to create a new Multidev, please contact Support.

How many Multidev environments do I get?

Each site has a limit of 10 Multidev environments.

Autopilot creates and uses a Multidev environment that does not count towards the total limit.

Can I buy additional Multidev environments?

Elite sites can request additional Multidev environments from support as needed.

If I use SFTP mode on a branch environment, do all environments have to be in SFTP mode?

No. Each branch environment can be independently set to use either SFTP or Git mode for code changes.

What access controls or permissions are available?

At this time, there are no permissions or access controls for managing the deployment and development workflow beyond the existing team functionality. This is a known feature request and is scheduled for a future release.

What are the naming conventions for branches?

Branch names can contain any ASCII letter and number (a through z, 0 through 9) and hyphen (dash). The branch name must start with a letter or number. Currently, the maximum length is 11 characters and environments cannot be created with the following reserved names: master, settings, team, support, debug, multidev, files, tags, and billing.

Can I fork my code without using Multidev?

Yes, you can; your Git repository is not restricted. If you do not use Multidev, then the interface will not show the branches, allow creation of an environment for a branch, and so forth.

Can I create a new environment for my local branch?

Yes. Push a new branch from your local (e.g., git push origin example-br) then navigate to Multidev > Git Branches from your Site Dashboard and select Create Environment next to the branch name.

Is there a limit on the number of branches or environments?

There is no limit on the number of branches you can have in your Git repository. The limit on Multidev environments is 10 per site.

Can I associate a domain with a branch environment?

Yes, you can assign custom domains to each Multidev environment.

What Git clients are supported?

You can use any Git client with Multidev. Use of the command-line Git client is recommended for compatibility with Dashboard instructions.

Does Multidev support remote repositories, such as GitHub?

At this time, Multidev on Pantheon will only work with the Pantheon hosted code repository. You can use remote repositories with your workflow, but Multidev on Pantheon will only recognize changes pushed to Pantheon.

Is there a public API available for post-commit hooks or other integrations with external project management systems?

No, but developers can use Quicksilver hooks to integrate Multidev creation and other workflows with external services.

Can I backup and restore a branch environment?

Yes, you can backup and restore a branch environment. However, if you restore an old version of code in Dev, you may damage Multidev environments.

Will I lose access to Multidevs if the organization downgrades the plan?

If the organization changes to a plan that doesn't feature Multidev, you will still be able to access existing Multidev environments, but will not be able to create new ones.

How long will the Multidev stay active?

Multidev environments spin down after approximately 60 minutes of idle time. Refer to the Idle Containers documentation for more information.

Creating a Multidev Failed - Specified Key Was Too Long

Users encounter this error with sites that use the MyISAM engine with a varchar index that exceeds 767 bytes. To resolve, convert MyISAM tables to InnoDB.