{"id":35012,"date":"2025-12-20T16:33:07","date_gmt":"2025-12-20T09:33:07","guid":{"rendered":"https:\/\/dps.media\/?p=35012"},"modified":"2025-12-20T16:33:09","modified_gmt":"2025-12-20T09:33:09","slug":"huong-dan-migrate-n8n-sang-vps-moi-docker-day-du-an-toan-2","status":"publish","type":"post","link":"https:\/\/dps.media\/en\/huong-dan-migrate-n8n-sang-vps-moi-docker-day-du-an-toan-2\/","title":{"rendered":"Guide to migrate n8n to a new VPS (Docker) \u2013 Complete & Safe"},"content":{"rendered":"

Migrating n8n from old VPS to new VPS sounds simple, but in reality, if you miss a few important steps, you may face serious errors such as losing credentials, webhook not working, or even the entire workflow disappearing.<\/p>\n\n\n\n

This article is written based on real-world experience when migrating n8n in a production environment, ensuring the safest and most complete process.<\/p>\n\n\n\n

\"\"
<\/figcaption><\/figure>\n\n\n\n

Objective of the migration process<\/h2>\n\n\n\n

After completing the migration, the new VPS must ensure:<\/p>\n\n\n\n

    \n
  • Normal n8n login<\/li>\n\n\n\n
  • All workflows remain intact<\/li>\n\n\n\n
  • Credentials are not faulty (no red color displayed)<\/li>\n\n\n\n
  • Webhooks and Cron operate stably<\/li>\n\n\n\n
  • Execution history is preserved<\/li>\n<\/ul>\n\n\n\n

    Components to be migrated (VERY IMPORTANT)<\/h2>\n\n\n\n

    A complete n8n stack includes 4 mandatory parts:<\/p>\n\n\n\n

    1. Database<\/h3>\n\n\n\n
      \n
    • PostgreSQL \/ MySQL \/ SQLite<\/li>\n<\/ul>\n\n\n\n

      2. n8n data directory<\/h3>\n\n\n\n
        \n
      • Workflows<\/li>\n\n\n\n
      • Credentials<\/li>\n\n\n\n
      • Executions<\/li>\n<\/ul>\n\n\n\n

        3. Environment variables<\/h3>\n\n\n\n
          \n
        • Especially N8N_ENCRYPTION_KEY<\/code><\/li>\n<\/ul>\n\n\n\n

          4. Domain & webhook configuration<\/h3>\n\n\n\n

          Note:<\/strong> Missing even one of these four parts can cause serious errors in the entire system.<\/p>\n\n\n\n

          \n\n\n\n

          Step 1: Prepare on old VPS (Source VPS)<\/h2>\n\n\n\n

          1.1. Check if n8n is running<\/h3>\n\n\n\n

          \u0110\u1ea7u ti\u00ean, ki\u1ec3m tra xem n8n \u0111ang ch\u1ea1y nh\u01b0 th\u1ebf n\u00e0o:<\/p>\n\n\n\n

          bash<\/p>\n\n\n\n

          docker ps\ndocker compose ps<\/code><\/pre>\n\n\n\n
          X\u00e1c \u0111\u1ecbnh c\u00e1c th\u00f4ng tin sau:<\/p>\n\n\n\n
            \n
          • Type of database in use<\/li>\n\n\n\n
          • Volume \u0111ang mount \u1edf \u0111\u00e2u (~\/.n8n<\/code> or Docker volume)<\/li>\n<\/ul>\n\n\n\n
            1.2. Backup database<\/h3>\n\n\n\n
            With PostgreSQL:<\/strong><\/p>\n\n\n\n
            bash<\/p>\n\n\n\n
            docker exec -t postgres \\\n  pg_dump -U n8n n8n > n8n.sql<\/code><\/pre>\n\n\n\n
            With MySQL:<\/strong><\/p>\n\n\n\n
            bash<\/p>\n\n\n\n
            docker exec -t mysql \\\n  mysqldump -u n8n -p n8n > n8n.sql<\/code><\/pre>\n\n\n\n
            With SQLite:<\/strong><\/p>\n\n\n\n
            bash<\/p>\n\n\n\n
            cp ~\/.n8n\/database.sqlite n8n.sqlite<\/code><\/pre>\n\n\n\n
            1.3. Backup n8n data<\/h3>\n\n\n\n
            If using bind mount:<\/strong><\/p>\n\n\n\n
            bash<\/p>\n\n\n\n
            tar -czvf n8n-data.tar.gz ~\/.n8n<\/code><\/pre>\n\n\n\n
            If using Docker volume:<\/strong><\/p>\n\n\n\n
            bash<\/p>\n\n\n\n
            docker run --rm \\\n  -v n8n_data:\/data \\\n  -v $(pwd):\/backup \\\n  alpine tar czvf \/backup\/n8n-data.tar.gz \/data<\/code><\/pre>\n\n\n\n
            Important notes:<\/strong> This directory contains all encrypted credentials.<\/p>\n\n\n\n
            1.4. Save environment variables (.env)<\/h3>\n\n\n\n
            File .env<\/code> must have the following variables:<\/p>\n\n\n\n
            env<\/p>\n\n\n\n
            N8N_ENCRYPTION_KEY=\nDB_TYPE=\nDB_POSTGRESDB_DATABASE=\nDB_POSTGRESDB_USER=\nDB_POSTGRESDB_PASSWORD=\nN8N_HOST=\nWEBHOOK_URL=<\/code><\/pre>\n\n\n\n
            \u26a0\ufe0f WARNING:<\/strong> Loss N8N_ENCRYPTION_KEY<\/code> means losing all credentials!<\/p>\n\n\n\n
            \n\n\n\n
            Step 2: Prepare new VPS (Destination VPS)<\/h2>\n\n\n\n
            2.1. Install Docker & Docker Compose<\/h3>\n\n\n\n
            bash<\/p>\n\n\n\n
            apt update && apt upgrade -y\napt install docker.io docker-compose-plugin -y\nsystemctl enable docker --now<\/code><\/pre>\n\n\n\n
            2.2. Create project directory<\/h3>\n\n\n\n
            bash<\/p>\n\n\n\n
            mkdir -p \/opt\/n8n\ncd \/opt\/n8n<\/code><\/pre>\n\n\n\n
            Copy the following files into this directory:<\/p>\n\n\n\n
              \n
            • docker-compose.yml<\/code><\/li>\n\n\n\n
            • .env<\/code><\/li>\n\n\n\n
            • Backup file (n8n.sql<\/code>, n8n-data.tar.gz<\/code>)<\/li>\n<\/ul>\n\n\n\n
              \n\n\n\n
              Step 3: Restore data on new VPS<\/h2>\n\n\n\n
              3.1. Restore n8n data<\/h3>\n\n\n\n
              With bind mount:<\/strong><\/p>\n\n\n\n
              bash<\/p>\n\n\n\n
              tar -xzvf n8n-data.tar.gz -C \/<\/code><\/pre>\n\n\n\n
              With Docker volume:<\/strong><\/p>\n\n\n\n
              bash<\/p>\n\n\n\n
              docker volume create n8n_data\n\ndocker run --rm \\\n  -v n8n_data:\/data \\\n  -v $(pwd):\/backup \\\n  alpine tar xzvf \/backup\/n8n-data.tar.gz -C \/<\/code><\/pre>\n\n\n\n
              3.2. Restore database<\/h3>\n\n\n\n
              PostgreSQL:<\/strong><\/p>\n\n\n\n
              bash<\/p>\n\n\n\n
              docker compose up -d postgres\ndocker exec -i postgres \\\n  psql -U n8n n8n < n8n.sql<\/code><\/pre>\n\n\n\n
              MySQL:<\/strong><\/p>\n\n\n\n
              bash<\/p>\n\n\n\n
              docker compose up -d mysql\ndocker exec -i mysql \\\n  mysql -u n8n -p n8n < n8n.sql<\/code><\/pre>\n\n\n\n
              \n\n\n\n
              Step 4: Start n8n<\/h2>\n\n\n\n
              Start n8n:<\/p>\n\n\n\n
              bash<\/p>\n\n\n\n
              docker compose up -d<\/code><\/pre>\n\n\n\n
              Monitor logs to check:<\/p>\n\n\n\n
              bash<\/p>\n\n\n\n
              docker compose logs -f n8n<\/code><\/pre>\n\n\n\n
              When you see the following log line, n8n has started successfully:<\/p>\n\n\n\n
              Editor is now accessible via:<\/code><\/pre>\n\n\n\n
              \n\n\n\n
              Step 5: Fix domain & webhook (THE MOST EASILY FORGOTTEN STEP)<\/h2>\n\n\n\n
              5.1. Update .env file<\/h3>\n\n\n\n
              env<\/p>\n\n\n\n
              N8N_HOST=n8n.domainmoi.com\nN8N_PROTOCOL=https\nWEBHOOK_URL=https:\/\/n8n.domainmoi.com\/<\/code><\/pre>\n\n\n\n
              Then restart n8n:<\/p>\n\n\n\n
              bash<\/p>\n\n\n\n
              docker compose restart n8n<\/code><\/pre>\n\n\n\n
              5.2. Test webhook<\/h3>\n\n\n\n
                \n
              1. Open workflow with webhook<\/li>\n\n\n\n
              2. Click Test URL<\/strong><\/li>\n\n\n\n
              3. Test by calling with browser or curl<\/li>\n<\/ol>\n\n\n\n
                If webhook errors, it is almost certainly due to WEBHOOK_URL<\/code> not being configured correctly.<\/p>\n\n\n\n
                \n\n\n\n
                Step 6: Post-migration checklist<\/h2>\n\n\n\n
                  \n
                • \u2705 Successfully logged into n8n<\/li>\n\n\n\n
                • \u2705 Workflow is still sufficient<\/li>\n\n\n\n
                • \u2705 Credentials not showing red<\/li>\n\n\n\n
                • \u2705 Webhook works normally<\/li>\n\n\n\n
                • \u2705 Cron workflow runs on schedule<\/li>\n\n\n\n
                • \u2705 Execution history is intact<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n
                  Common errors when migrating n8n<\/h2>\n\n\n\n
                  Error<\/th>Cause<\/th>How to handle<\/th><\/tr><\/thead>
                  Credentials error<\/td>Lost encryption key<\/td>Reuse old key<\/td><\/tr>
                  Webhook returns 404<\/td>Wrong WEBHOOK_URL<\/code><\/td>Set correct domain<\/td><\/tr>
                  No workflow found<\/td>DB not restored yet<\/td>Re-import SQL<\/td><\/tr>
                  n8n restarts continuously<\/td>Wrong DB env<\/td>Check again .env<\/code><\/td><\/tr>
                  OAuth error<\/td>Change domain<\/td>Re-authorize<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                  \n\n\n\n
                  Real-world experience<\/h2>\n\n\n\n
                  Always stop n8n before backup:<\/strong><\/p>\n\n\n\n
                  bash<\/p>\n\n\n\n
                  docker compose stop n8n<\/code><\/pre>\n\n\n\n
                  Some other notes:<\/strong><\/p>\n\n\n\n
                    \n
                  • Production environment should use PostgreSQL instead of SQLite<\/li>\n\n\n\n
                  • Save file .env<\/code> to password manager to avoid loss<\/li>\n\n\n\n
                  • Take VPS snapshot before migrate to be able to rollback if needed<\/li>\n\n\n\n
                  • If using queue mode, remember to migrate Redis as well<\/li>\n<\/ul>\n\n\n\n
                    \n\n\n\n
                    Conclusion<\/h2>\n\n\n\n
                    Migrating n8n to a new VPS will be completely safe if you ensure all 4 pillars:<\/p>\n\n\n\n
                      \n
                    1. Database<\/strong> \u2013 Contains all workflows and executions<\/li>\n\n\n\n
                    2. n8n data<\/strong> \u2013 Credentials and configuration<\/li>\n\n\n\n
                    3. Encryption key<\/strong> \u2013 To decrypt credentials<\/li>\n\n\n\n
                    4. Webhook<\/strong> \u2013 Ensure domain and URL are correct<\/li>\n<\/ol>\n\n\n\n
                      If you're having trouble during the migration process or need further support, don't hesitate to leave a comment below. Let me know:<\/p>\n\n\n\n
                        \n
                      • Are you using PostgreSQL or MySQL?<\/li>\n\n\n\n
                      • Single n8n or queue mode?<\/li>\n\n\n\n
                      • Are you using reverse proxy (Nginx \/ Traefik \/ Cloudflare)?<\/li>\n<\/ul>\n\n\n\n
                        I will support and provide specific commands suitable for your stack!<\/p>","protected":false},"excerpt":{"rendered":"
                        Migrating n8n from the old VPS to the new VPS sounds simple, but in reality, if you miss a few important steps, you may face serious errors such as losing credentials, webhooks not working, or even the entire workflow disappearing. This article is written based on [\u2026]<\/p>","protected":false},"author":1,"featured_media":35013,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,1205],"tags":[],"class_list":["post-35012","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","category-n8n-marketing"],"acf":[],"rankmath_keywords":{"primary":"","secondary":[""]},"yoast_keywords":{"primary":"","secondary":[]},"yoast_focuskw":"","rankmath_focuskw":"","seo_keywords":{"primary":"","secondary":[""]},"_links":{"self":[{"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/posts\/35012","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/comments?post=35012"}],"version-history":[{"count":0,"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/posts\/35012\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/media\/35013"}],"wp:attachment":[{"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/media?parent=35012"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/categories?post=35012"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dps.media\/en\/wp-json\/wp\/v2\/tags?post=35012"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}