path: root/devdocs/vagrant/cli%2Fglobal-status.html

<h1 id="global-status">  Global Status </h1> <p><strong>Command: <code>vagrant global-status</code></strong></p> <p>This command will tell you the state of all active Vagrant environments on the system for the currently logged in user.</p> <blockquote class="alert alert-warning" role="alert"> <p><strong>This command does not actively verify the state of machines</strong>, and is instead based on a cache. Because of this, it is possible to see stale results (machines say they're running but they're not). For example, if you restart your computer, Vagrant would not know. To prune the invalid entries, run global status with the <code>--prune</code> flag.</p> </blockquote> <p>The IDs in the output that look like <code>a1b2c3</code> can be used to control the Vagrant machine from anywhere on the system. Any Vagrant command that takes a target machine (such as <code>up</code>, <code>halt</code>, <code>destroy</code>) can be used with this ID to control it. For example: <code>vagrant destroy a1b2c3</code>.</p> <h2 id="options">  Options </h2> <ul> <li>
<a href="#prune"><code>--prune</code></a> - Prunes invalid entries from the list. This is much more time consuming than simply listing the entries. </li> </ul> <h2 id="environment-not-showing-up">  Environment Not Showing Up </h2> <p>If your environment is not showing up, you may have to do a <code>vagrant destroy</code> followed by a <code>vagrant up</code>.</p> <p>If you just upgraded from a previous version of Vagrant, existing environments will not show up in global-status until they are destroyed and recreated.</p><div class="_attribution">
  <p class="_attribution-p">
    &copy; 2010&ndash;2018 Mitchell Hashimoto<br>Licensed under the MPL 2.0 License.<br>
    <a href="https://www.vagrantup.com/docs/cli/global-status.html" class="_attribution-link">https://www.vagrantup.com/docs/cli/global-status.html</a>
  </p>
</div>