Documentation

​
​

Development

User Acquisition

Monetization

Industry

Self-Hosted Deployment

Amazon Web Services

Microsoft Azure

On premises

vpctl

Self-Hosted Deployment

​
​
Self-Hosted Deployment
  • Overview
  • Amazon Web Services
  • Microsoft Azure
  • On premises
  • Administration
  • Security
  • vpctl
    • vpctl Architecture
    • Installation
    • Manifest reference
    • vpctl commands
    • Troubleshooting
    • Changelog
  1. Self-Hosted Deployment (previously called Unity Virtual Private Cloud)
  3. vpctl command-line tool

Troubleshooting

Common vpctl errors and resolutions
Read time 1 minute
Last updated a month ago
If a vpctl command fails, rerun the command with 
--log-level debug
to view detailed error output. Common issues are listed below.

"No credentials found for registry"

Run 
vpctl configure
to set up your registry credentials. For more information, refer Install vpctl.

"Manifest file not found"

Ensure that 
manifest.yaml
exists in the current directory or a parent directory. You can also use 
--manifest <path>
to specify the path.

"Secrets file does not exist"

Run 
vpctl secret generate
to create the secrets file. For more information, refer vpctl secret.

"vpctl version X is older than the minimum required version Y"

Your vpctl binary is older than the version required by the release package you pulled. Upgrade vpctl to at least the version shown in the error message. To bypass this check temporarily, use 
--skip-version-check
.

"Failed to pull artifact"

  • Verify that your registry credentials are correct.
  • Check that the version exists in the registry.
  • Ensure that you can access the registry over the network.

Getting more detail

Append 
--log-level debug
to all commands to view a detailed log output.
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • "No credentials found for registry"

    • "Manifest file not found"

    • "Secrets file does not exist"

    • "vpctl version X is older than the minimum required version Y"

    • "Failed to pull artifact"

    • Getting more detail

Report a problem with this page