You are browsing Nuxt 2 docs. Go to Nuxt 3 docs, or learn more about Nuxt 2 Long Term Support.

Deploy Nuxt on Dokku

How to deploy a Nuxt application on Dokku?

We recommend to read Dokku documentation for the setup and Deploying a Node.js Application on Digital Ocean using Dokku .

For the example, we will call our Nuxt application my-nuxt-app.

We need to tell Dokku to install the devDependencies of the project (to be able to launch npm run build):

// on Dokku Server
dokku config:set my-nuxt-app NPM_CONFIG_PRODUCTION=false YARN_PRODUCTION=false

Also, we want our application to listen on the host and run in production mode:

// on Dokku Server
dokku config:set my-nuxt-app HOST= NODE_ENV=production

You should see these 3 lines when you type dokku config my-nuxt-app

nuxt config vars Dokku

Then, we tell Dokku to launch npm run build via the scripts.dokku.predeploy script in our project app.json:

create a file name app.json in our project root folder

  "scripts": {
    "dokku": {
      "predeploy": "npm run build"

To launch the application we run npm run start using the Procfile :

web: npm run start

Finally, we can push our app on Dokku with:

// commit your change before push.
git remote add dokku dokku@yourServer:my-nuxt-app
git push dokku master

Voilà! Our Nuxt application is now hosted on Dokku!