# Standalone App :::warning v9 compatibility The standalone app remains on v8 and is not included in Vue DevTools v9. ::: > In case you are using an unsupported browser, or if you have other specific needs (for example your application is in Electron), you can use the standalone application. ![electron](/features/electron.png) ## Installation ### Install the package globally: ::: code-group ```sh [npm] $ npm add -g @vue/devtools ``` ```sh [pnpm] $ pnpm add -g @vue/devtools ``` ```sh [yarn] $ yarn global add @vue/devtools ``` ```sh [bun] $ bun add -g @vue/devtools ``` ::: ### Or locally as a project dependency: ::: code-group ```sh [npm] $ npm add -D @vue/devtools ``` ```sh [pnpm] $ pnpm add -D @vue/devtools ``` ```sh [yarn] $ yarn add -D @vue/devtools ``` ```sh [bun] $ bun add -D @vue/devtools ``` ::: ## Usage ### Using the global package After installing the package globally, run: ```sh vue-devtools ``` Then add this code to the `` section of your application HTML file: ```html ``` Or if you want to debug your device remotely: ```html ``` :::tip `` usually looks like this: `192.168.x.x`. ::: :::warning Note **Don't forget to remove it before deploying to production!** ::: ### Using a local dependency After installing the package as a project dependency, run: ```sh ./node_modules/.bin/vue-devtools ``` :::tip You can also use the global `vue-devtools` to start the app, but you might want to check if the local version matches the global one in this scenario to avoid any incompatibilities. ::: Then import it directly in your app: ```ts import { devtools } from '@vue/devtools' ``` Then connect to the host: ```ts if (process.env.NODE_ENV === 'development') devtools.connect(/* host (the default is "http://localhost"), port (the default is 8090) */) ``` :::tip Important Call `devtools.connect()` before creating the Vue app; otherwise, it may not work as expected. ::: **host** - is an optional argument that tells your application where devtools middleware server is running, if you debug your app on your computer you don't have to set this (the default is `http://localhost`), but if you want to debug your app on mobile devices, you might want to pass your local IP (e.g. `http://192.168.1.12`). **port** - is an optional argument that tells your application on what port devtools middleware server is running. If you use proxy server, you might want to set it to `null` so the port won't be added to connection URL. ## FAQ ### 1. How do I change the DevTools server port? Set the `PORT` environment variable when starting the server: ```sh PORT=8000 vue-devtools ``` Then in your app you'll have to set either: ```ts window.__VUE_DEVTOOLS_PORT__ = 8000 ``` Or pass the new port to `connect()`: ```ts devtools.connect(/ host /, 8000) ``` ### 2. How do I inspect a page on a remote server? For that you can use `ngrok` proxy. You can download it [here](https://ngrok.com/). After starting `vue-devtools`, run: ```sh ngrok http 8098 ``` Then update your host and port accordingly: ```ts devtools.connect('https://example.ngrok.io', null) ``` Make sure to set port to `null` or `false`, because `ngrok` host already proxies to proper port that we defined in the first command. ### 3. How do I inspect a page served over HTTPS? For that you can also use ngrok, as it automatically proxies https requests to http. Take a look at question number 2 for instructions. ### 4. How do I inspect Cordova applications? Make sure that the page under `http://your-ip:8098` is returning a javascript code on your device/simulator. If it doesn't - make sure to check your anti-virus or router/firewall settings. If it works - please follow the instructions, and connect to devtools using your IP. For example: ```ts import devtools from '@vue/devtools' import Vue from 'vue' // ... function onDeviceReady() { devtools.connect('http://192.168.xx.yy') // use your IP } if (window.location.protocol === 'file:') document.addEventListener('deviceready', onDeviceReady, false) else onDeviceReady() ``` This only works with a development build of your app.