The Easiest Way to Install n8n on Ubuntu 22.04 VPS<\/title><\/p>\n<style>\n body { \n font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; \n background-color: #0d1117; \n color: #e6edf3; \n padding: 2em; \n line-height: 1.6; \n max-width: 1200px; \n margin: 0 auto; \n }\n h1 { \n color: #7dd3fc; \n border-bottom: 3px solid #7dd3fc; \n padding-bottom: 0.5em; \n margin-bottom: 1em;\n font-size: 2.5em;\n }\n h2 { \n color: #34d399; \n border-left: 4px solid #34d399; \n padding-left: 1em; \n margin-top: 2em;\n font-size: 1.8em;\n }\n h3 { \n color: #fbbf24; \n font-size: 1.4em;\n margin-top: 1.5em;\n }\n h4 { \n color: #f87171; \n font-size: 1.2em;\n margin-top: 1.2em;\n }\n pre { \n background: #161b22; \n color: #7dd3fc; \n padding: 1.5em; \n border-radius: 8px; \n overflow-x: auto; \n border: 1px solid #30363d;\n margin: 1em 0;\n font-family: 'Courier New', monospace;\n }\n code { \n background: #21262d; \n color: #7dd3fc; \n padding: 0.2em 0.4em; \n border-radius: 4px; \n font-family: 'Courier New', monospace; \n }\n a { \n color: #58a6ff; \n text-decoration: none; \n font-weight: 500;\n }\n a:hover { \n text-decoration: underline; \n color: #79c0ff;\n }\n .warning {\n background: #2d1b17;\n border-left: 4px solid #f85149;\n padding: 1em;\n margin: 1em 0;\n border-radius: 0 6px 6px 0;\n color: #ffa198;\n }\n .info {\n background: #0f2938;\n border-left: 4px solid #58a6ff;\n padding: 1em;\n margin: 1em 0;\n border-radius: 0 6px 6px 0;\n color: #b6e3ff;\n }\n .success {\n background: #0f2419;\n border-left: 4px solid #56d364;\n padding: 1em;\n margin: 1em 0;\n border-radius: 0 6px 6px 0;\n color: #aff5b4;\n }\n ul, ol {\n padding-left: 2em;\n }\n li {\n margin: 0.5em 0;\n }\n .command-block {\n background: #0d1117;\n border: 2px solid #21262d;\n border-radius: 8px;\n margin: 1em 0;\n }\n .command-title {\n background: #21262d;\n color: #7dd3fc;\n padding: 0.5em 1em;\n margin: 0;\n font-weight: bold;\n border-bottom: 1px solid #30363d;\n }\n strong {\n color: #ffa657;\n font-weight: 600;\n }\n .highlight {\n background: #2d1b17;\n color: #ffa198;\n padding: 0.2em 0.4em;\n border-radius: 4px;\n font-weight: bold;\n }\n <\/style>\n<p><\/head><br \/>\n<body><\/p>\n<h1>The Complete Guide to Installing n8n on Ubuntu 22.04 VPS<\/h1>\n<p>The easiest way to install <strong>n8n<\/strong> on a newly deployed Ubuntu 22.04 VPS server is by using Docker, which requires minimal steps while ensuring a complete and secure installation. This guide provides the exact commands needed with all the latest best practices and corrections.<\/p>\n<div class=\"info\">\n<strong>\u2705 Technical Accuracy Note:<\/strong> This guide has been fact-checked and corrected for 2025. All commands use the latest official Docker installation methods and include proper WebSocket support for n8n’s real-time features.<\/div>\n<h2>\ud83d\ude80 Step 1: Update Your System<\/h2>\n<pre><code>sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n<h2>\ud83d\udc33 Step 2: Install Docker with Latest Official Method<\/h2>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Install Required Dependencies<\/h4>\n<pre><code>sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Add Docker’s Official GPG Key (2025 Method)<\/h4>\n<pre><code>sudo mkdir -p \/etc\/apt\/keyrings\ncurl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg | sudo gpg --dearmor -o \/etc\/apt\/keyrings\/docker.gpg\nsudo chmod a+r \/etc\/apt\/keyrings\/docker.gpg<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Add Docker Repository with Dynamic Detection<\/h4>\n<pre><code>echo \"deb [arch=$(dpkg --print-architecture) signed-by=\/etc\/apt\/keyrings\/docker.gpg] https:\/\/download.docker.com\/linux\/ubuntu $(. \/etc\/os-release && echo \"$VERSION_CODENAME\") stable\" | sudo tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Install Docker Engine with All Components<\/h4>\n<pre><code>sudo apt update\nsudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Verify Installation<\/h4>\n<pre><code>docker --version\nsudo systemctl status docker<\/code><\/pre>\n<\/div>\n<h2>\ud83d\udcc1 Step 3: Prepare n8n Data Directory<\/h2>\n<pre><code>mkdir -p ~\/.n8n\nsudo chown -R 1000:1000 ~\/.n8n\nsudo chmod -R 755 ~\/.n8n<\/code><\/pre>\n<div class=\"info\">\n<strong>Why UID 1000?<\/strong> The n8n Docker container runs with user ID 1000 by default. Setting ownership to 1000:1000 ensures proper file permissions.<\/div>\n<h2>\ud83d\ude80 Step 4: Deploy n8n Container with Proper Configuration<\/h2>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Pull n8n Image<\/h4>\n<pre><code>docker pull n8nio\/n8n<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Run n8n Container with Auto-Restart<\/h4>\n<pre><code>docker run -d \\\n --name n8n \\\n --restart unless-stopped \\\n -p 5678:5678 \\\n -v ~\/.n8n:\/home\/node\/.n8n \\\n n8nio\/n8n<\/code><\/pre>\n<\/div>\n<div class=\"success\">\n<strong>\u2705 Improvement:<\/strong> The restart policy is now set directly in the initial command, eliminating the need for a separate <code>docker update<\/code> step.<\/div>\n<h2>\ud83c\udf10 Step 5: Access Your n8n Instance<\/h2>\n<p>Visit: <code>http:\/\/YOUR_SERVER_IP:5678<\/code> (replace with your actual VPS IP address)<\/p>\n<div class=\"warning\">\n<strong>\u26a0\ufe0f Security Note:<\/strong> This HTTP setup is only for initial testing. Follow the SSL configuration steps below for production use.<\/div>\n<h2>\ud83d\udd12 SSL Configuration for Production Use<\/h2>\n<p>You have two options for SSL configuration. <strong>Option 1 is strongly recommended<\/strong> for production environments.<\/p>\n<h3>\ud83c\udfaf Option 1: Nginx Reverse Proxy with Certbot (Recommended)<\/h3>\n<h4>1. Install Nginx<\/h4>\n<pre><code>sudo apt install -y nginx<\/code><\/pre>\n<h4>2. Create Enhanced Nginx Configuration with WebSocket Support<\/h4>\n<pre><code>sudo nano \/etc\/nginx\/sites-available\/n8n<\/code><\/pre>\n<p>Paste the following configuration (replace <code class=\"highlight\">n8n.yourdomain.com<\/code> with your actual domain):<\/p>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Complete Nginx Configuration<\/h4>\n<pre><code># WebSocket upgrade mapping\nmap $http_upgrade $connection_upgrade {\n default upgrade;\n '' close;\n}\n\nserver {\n listen 80;\n server_name n8n.yourdomain.com;\n\n # Security headers\n add_header X-Frame-Options \"SAMEORIGIN\" always;\n add_header X-XSS-Protection \"1; mode=block\" always;\n add_header X-Content-Type-Options \"nosniff\" always;\n\n location \/ {\n proxy_pass http:\/\/localhost:5678;\n proxy_http_version 1.1;\n \n # WebSocket support (CRITICAL for n8n)\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection $connection_upgrade;\n \n # Standard proxy headers\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Port $server_port;\n \n # WebSocket and performance settings\n proxy_cache_bypass $http_upgrade;\n proxy_buffering off;\n proxy_cache off;\n chunked_transfer_encoding off;\n \n # Timeouts for WebSocket connections\n proxy_connect_timeout 7d;\n proxy_send_timeout 7d;\n proxy_read_timeout 7d;\n }\n}<\/code><\/pre>\n<\/div>\n<div class=\"info\">\n<strong>\ud83d\udd27 Critical Enhancement:<\/strong> This configuration includes proper WebSocket support with upgrade mapping, which is essential for n8n’s real-time features like workflow execution monitoring.<\/div>\n<h4>3. Enable and Test Configuration<\/h4>\n<pre><code>sudo ln -s \/etc\/nginx\/sites-available\/n8n \/etc\/nginx\/sites-enabled\/\nsudo nginx -t\nsudo systemctl restart nginx<\/code><\/pre>\n<h4>4. Install Certbot and Obtain SSL Certificate<\/h4>\n<pre><code>sudo apt install -y certbot python3-certbot-nginx\nsudo certbot --nginx -d n8n.yourdomain.com<\/code><\/pre>\n<h4>5. Verify HTTPS Setup<\/h4>\n<p>Access your secure n8n instance at: <code>https:\/\/n8n.yourdomain.com<\/code><\/p>\n<h4>6. Verify Auto-Renewal<\/h4>\n<pre><code>sudo systemctl list-timers | grep certbot\nsudo certbot renew --dry-run<\/code><\/pre>\n<div class=\"success\">\n<strong>\u2705 Automatic Renewal:<\/strong> Certbot automatically configures certificate renewal. No manual intervention required.<\/div>\n<h3>\u2699\ufe0f Option 2: Direct Docker SSL Configuration (Advanced Users)<\/h3>\n<div class=\"warning\">\n<strong>\u26a0\ufe0f Manual Certificate Management Required:<\/strong> This option requires you to handle certificate renewals manually. Only recommended for advanced users with specific requirements.<\/div>\n<h4>1. Prepare Certificate Directory<\/h4>\n<pre><code>mkdir -p ~\/n8n\/certificates\n# Place your certificate files:\n# ~\/n8n\/certificates\/cert.pem (full certificate chain)\n# ~\/n8n\/certificates\/privkey.pem (private key)<\/code><\/pre>\n<h4>2. Stop Existing Container<\/h4>\n<pre><code>docker stop n8n\ndocker rm n8n<\/code><\/pre>\n<h4>3. Run n8n with SSL Configuration<\/h4>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Corrected SSL Docker Command<\/h4>\n<pre><code>docker run -d \\\n --name n8n \\\n --restart unless-stopped \\\n -p 443:5678 \\\n -v ~\/.n8n:\/home\/node\/.n8n \\\n -v ~\/n8n\/certificates:\/certs \\\n -e N8N_HOST=\"n8n.yourdomain.com\" \\\n -e N8N_PORT=5678 \\\n -e N8N_PROTOCOL=https \\\n -e WEBHOOK_URL=\"https:\/\/n8n.yourdomain.com\/\" \\\n -e N8N_SSL_CERT_FILE=\"\/certs\/cert.pem\" \\\n -e N8N_SSL_KEY_FILE=\"\/certs\/privkey.pem\" \\\n n8nio\/n8n<\/code><\/pre>\n<\/div>\n<div class=\"success\">\n<strong>\u2705 Fixed Configuration:<\/strong> This corrected version uses file-based certificates with proper volume mounting and includes all required environment variables.<\/div>\n<h2>\ud83d\udd27 Important Configuration Notes<\/h2>\n<div class=\"info\">\n<strong>WebSocket Support:<\/strong> n8n requires WebSocket connections for real-time workflow execution monitoring. The Nginx configuration above includes proper WebSocket upgrade handling, which is critical for full functionality.<\/div>\n<div class=\"info\">\n<strong>Firewall Configuration:<\/strong> Ensure your VPS firewall allows traffic on:<\/p>\n<ul>\n<li>Port 80 (HTTP) – for initial setup and Certbot verification<\/li>\n<li>Port 443 (HTTPS) – for secure access<\/li>\n<li>Port 22 (SSH) – for server management<\/li>\n<\/ul>\n<\/div>\n<h2>\ud83d\udee0\ufe0f Troubleshooting Common Issues<\/h2>\n<h3>Docker Permission Issues<\/h3>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Add User to Docker Group<\/h4>\n<pre><code>sudo usermod -aG docker $USER\nnewgrp docker\n# or logout and login again<\/code><\/pre>\n<\/div>\n<h3>n8n Data Directory Permissions<\/h3>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Fix Permission Issues<\/h4>\n<pre><code>sudo chown -R 1000:1000 ~\/.n8n\nsudo chmod -R 755 ~\/.n8n<\/code><\/pre>\n<\/div>\n<h3>WebSocket Connection Issues<\/h3>\n<p>If workflows don’t update in real-time:<\/p>\n<ol>\n<li>Verify Nginx configuration includes WebSocket upgrade mapping<\/li>\n<li>Check that proxy headers are properly configured<\/li>\n<li>Ensure no firewall is blocking WebSocket connections<\/li>\n<\/ol>\n<h3>SSL Certificate Issues<\/h3>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Check Certificate Status<\/h4>\n<pre><code>sudo certbot certificates\nsudo certbot renew --dry-run<\/code><\/pre>\n<\/div>\n<h2>\ud83d\udcca Container Management Commands<\/h2>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Essential Docker Commands for n8n<\/h4>\n<pre><code># View container status\ndocker ps -a\n\n# View container logs\ndocker logs n8n\n\n# Follow logs in real-time\ndocker logs -f n8n\n\n# Restart container\ndocker restart n8n\n\n# Update n8n to latest version\ndocker pull n8nio\/n8n\ndocker stop n8n\ndocker rm n8n\n# Then run the docker run command again\n\n# Backup n8n data\ntar -czf n8n-backup-$(date +%Y%m%d).tar.gz ~\/.n8n<\/code><\/pre>\n<\/div>\n<h2>\ud83d\udd10 Security Recommendations<\/h2>\n<ul>\n<li><strong>Use Option 1 (Nginx + Certbot)<\/strong> for automatic SSL certificate management<\/li>\n<li><strong>Configure firewall rules<\/strong> to only allow necessary ports (22, 80, 443)<\/li>\n<li><strong>Regular backups<\/strong> of the <code>~\/.n8n<\/code> directory containing workflows and credentials<\/li>\n<li><strong>Keep Docker and n8n updated<\/strong> to the latest versions for security patches<\/li>\n<li><strong>Use strong passwords<\/strong> and enable two-factor authentication when available<\/li>\n<li><strong>Monitor logs regularly<\/strong> for any suspicious activity<\/li>\n<\/ul>\n<h2>\ud83d\udcda Additional Resources<\/h2>\n<ul>\n<li><a href=\"https:\/\/docs.n8n.io\/\" target=\"_blank\">Official n8n Documentation<\/a><\/li>\n<li><a href=\"https:\/\/docs.docker.com\/engine\/install\/ubuntu\/\" target=\"_blank\">Docker Installation Guide<\/a><\/li>\n<li><a href=\"https:\/\/nginx.org\/en\/docs\/\" target=\"_blank\">Nginx Documentation<\/a><\/li>\n<li><a href=\"https:\/\/certbot.eff.org\/\" target=\"_blank\">Certbot Documentation<\/a><\/li>\n<li><a href=\"https:\/\/community.n8n.io\/\" target=\"_blank\">n8n Community Forum<\/a><\/li>\n<\/ul>\n<div class=\"success\">\n<strong>\ud83c\udf89 Setup Complete!<\/strong> Your n8n instance is now ready for production use with proper SSL configuration, WebSocket support, and automatic certificate renewal. Happy automating!<\/div>\n<p><\/body><br \/>\n<\/html><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The Easiest Way to Install n8n on Ubuntu 22.04 VPS, A step-by-step guide<\/p>\n","protected":false},"author":1,"featured_media":783,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[7],"tags":[23],"class_list":["post-429","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tech","tag-tech"],"yoast_head":"\n<title>How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal\" \/>\n<meta property=\"og:description\" content=\"The Easiest Way to Install n8n on Ubuntu 22.04 VPS, A step-by-step guide\" \/>\n<meta property=\"og:url\" content=\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\" \/>\n<meta property=\"og:site_name\" content=\"Virtual Homelab Portal\" \/>\n<meta property=\"article:published_time\" content=\"2025-06-19T06:17:57+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-07-26T19:48:51+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\" \/>\n\t<meta property=\"og:image:width\" content=\"1024\" \/>\n\t<meta property=\"og:image:height\" content=\"768\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/webp\" \/>\n<meta name=\"author\" content=\"editor@virtualhomelab.win\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"editor@virtualhomelab.win\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\"},\"author\":{\"name\":\"editor@virtualhomelab.win\",\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\"},\"headline\":\"How to Install n8n on a Ubuntu 22.04 VPS\",\"datePublished\":\"2025-06-19T06:17:57+00:00\",\"dateModified\":\"2025-07-26T19:48:51+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\"},\"wordCount\":624,\"publisher\":{\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\"},\"image\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"keywords\":[\"Tech\"],\"articleSection\":[\"Tech\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\",\"url\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\",\"name\":\"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal\",\"isPartOf\":{\"@id\":\"https:\/\/virtualhomelab.win\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"datePublished\":\"2025-06-19T06:17:57+00:00\",\"dateModified\":\"2025-07-26T19:48:51+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\",\"url\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"contentUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"width\":1024,\"height\":768},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/virtualhomelab.win\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Install n8n on a Ubuntu 22.04 VPS\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/virtualhomelab.win\/#website\",\"url\":\"https:\/\/virtualhomelab.win\/\",\"name\":\"Virtual Homelab Protal\",\"description\":\"WordPress site about Technology, current events and Games\",\"publisher\":{\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/virtualhomelab.win\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\",\"name\":\"editor@virtualhomelab.win\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp\",\"contentUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp\",\"width\":1205,\"height\":310,\"caption\":\"editor@virtualhomelab.win\"},\"logo\":{\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/\"},\"sameAs\":[\"https:\/\/virtualhomelab.win\"],\"url\":\"https:\/\/virtualhomelab.win\/index.php\/author\/b8434cdcbaa800a6\/\"}]}<\/script>\n","yoast_head_json":{"title":"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","og_locale":"en_US","og_type":"article","og_title":"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal","og_description":"The Easiest Way to Install n8n on Ubuntu 22.04 VPS, A step-by-step guide","og_url":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","og_site_name":"Virtual Homelab Portal","article_published_time":"2025-06-19T06:17:57+00:00","article_modified_time":"2025-07-26T19:48:51+00:00","og_image":[{"width":1024,"height":768,"url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","type":"image\/webp"}],"author":"editor@virtualhomelab.win","twitter_card":"summary_large_image","twitter_misc":{"Written by":"editor@virtualhomelab.win","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#article","isPartOf":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/"},"author":{"name":"editor@virtualhomelab.win","@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0"},"headline":"How to Install n8n on a Ubuntu 22.04 VPS","datePublished":"2025-06-19T06:17:57+00:00","dateModified":"2025-07-26T19:48:51+00:00","mainEntityOfPage":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/"},"wordCount":624,"publisher":{"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0"},"image":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage"},"thumbnailUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","keywords":["Tech"],"articleSection":["Tech"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","url":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","name":"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal","isPartOf":{"@id":"https:\/\/virtualhomelab.win\/#website"},"primaryImageOfPage":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage"},"image":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage"},"thumbnailUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","datePublished":"2025-06-19T06:17:57+00:00","dateModified":"2025-07-26T19:48:51+00:00","breadcrumb":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage","url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","contentUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","width":1024,"height":768},{"@type":"BreadcrumbList","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/virtualhomelab.win\/"},{"@type":"ListItem","position":2,"name":"How to Install n8n on a Ubuntu 22.04 VPS"}]},{"@type":"WebSite","@id":"https:\/\/virtualhomelab.win\/#website","url":"https:\/\/virtualhomelab.win\/","name":"Virtual Homelab Protal","description":"WordPress site about Technology, current events and Games","publisher":{"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/virtualhomelab.win\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0","name":"editor@virtualhomelab.win","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/","url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp","contentUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp","width":1205,"height":310,"caption":"editor@virtualhomelab.win"},"logo":{"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/"},"sameAs":["https:\/\/virtualhomelab.win"],"url":"https:\/\/virtualhomelab.win\/index.php\/author\/b8434cdcbaa800a6\/"}]}},"jetpack_featured_media_url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts\/429","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/comments?post=429"}],"version-history":[{"count":20,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts\/429\/revisions"}],"predecessor-version":[{"id":1009,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts\/429\/revisions\/1009"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/media\/783"}],"wp:attachment":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/media?parent=429"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/categories?post=429"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/tags?post=429"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}

{"id":429,"date":"2025-06-19T01:17:57","date_gmt":"2025-06-19T06:17:57","guid":{"rendered":"https:\/\/virtualhomelab.win\/?p=429"},"modified":"2025-07-26T14:48:51","modified_gmt":"2025-07-26T19:48:51","slug":"how-to-install-n8n-on-ubuntu-22-04-vps","status":"publish","type":"post","link":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","title":{"rendered":"How to Install n8n on a Ubuntu 22.04 VPS"},"content":{"rendered":"

\n
\n
\n
\n
\n The Easiest Way to Install n8n on Ubuntu 22.04 VPS<\/title><\/p>\n<style>\n body { \n font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; \n background-color: #0d1117; \n color: #e6edf3; \n padding: 2em; \n line-height: 1.6; \n max-width: 1200px; \n margin: 0 auto; \n }\n h1 { \n color: #7dd3fc; \n border-bottom: 3px solid #7dd3fc; \n padding-bottom: 0.5em; \n margin-bottom: 1em;\n font-size: 2.5em;\n }\n h2 { \n color: #34d399; \n border-left: 4px solid #34d399; \n padding-left: 1em; \n margin-top: 2em;\n font-size: 1.8em;\n }\n h3 { \n color: #fbbf24; \n font-size: 1.4em;\n margin-top: 1.5em;\n }\n h4 { \n color: #f87171; \n font-size: 1.2em;\n margin-top: 1.2em;\n }\n pre { \n background: #161b22; \n color: #7dd3fc; \n padding: 1.5em; \n border-radius: 8px; \n overflow-x: auto; \n border: 1px solid #30363d;\n margin: 1em 0;\n font-family: 'Courier New', monospace;\n }\n code { \n background: #21262d; \n color: #7dd3fc; \n padding: 0.2em 0.4em; \n border-radius: 4px; \n font-family: 'Courier New', monospace; \n }\n a { \n color: #58a6ff; \n text-decoration: none; \n font-weight: 500;\n }\n a:hover { \n text-decoration: underline; \n color: #79c0ff;\n }\n .warning {\n background: #2d1b17;\n border-left: 4px solid #f85149;\n padding: 1em;\n margin: 1em 0;\n border-radius: 0 6px 6px 0;\n color: #ffa198;\n }\n .info {\n background: #0f2938;\n border-left: 4px solid #58a6ff;\n padding: 1em;\n margin: 1em 0;\n border-radius: 0 6px 6px 0;\n color: #b6e3ff;\n }\n .success {\n background: #0f2419;\n border-left: 4px solid #56d364;\n padding: 1em;\n margin: 1em 0;\n border-radius: 0 6px 6px 0;\n color: #aff5b4;\n }\n ul, ol {\n padding-left: 2em;\n }\n li {\n margin: 0.5em 0;\n }\n .command-block {\n background: #0d1117;\n border: 2px solid #21262d;\n border-radius: 8px;\n margin: 1em 0;\n }\n .command-title {\n background: #21262d;\n color: #7dd3fc;\n padding: 0.5em 1em;\n margin: 0;\n font-weight: bold;\n border-bottom: 1px solid #30363d;\n }\n strong {\n color: #ffa657;\n font-weight: 600;\n }\n .highlight {\n background: #2d1b17;\n color: #ffa198;\n padding: 0.2em 0.4em;\n border-radius: 4px;\n font-weight: bold;\n }\n <\/style>\n<p><\/head><br \/>\n<body><\/p>\n<h1>The Complete Guide to Installing n8n on Ubuntu 22.04 VPS<\/h1>\n<p>The easiest way to install <strong>n8n<\/strong> on a newly deployed Ubuntu 22.04 VPS server is by using Docker, which requires minimal steps while ensuring a complete and secure installation. This guide provides the exact commands needed with all the latest best practices and corrections.<\/p>\n<div class=\"info\">\n<strong>\u2705 Technical Accuracy Note:<\/strong> This guide has been fact-checked and corrected for 2025. All commands use the latest official Docker installation methods and include proper WebSocket support for n8n’s real-time features.<\/div>\n<h2>\ud83d\ude80 Step 1: Update Your System<\/h2>\n<pre><code>sudo apt update && sudo apt upgrade -y<\/code><\/pre>\n<h2>\ud83d\udc33 Step 2: Install Docker with Latest Official Method<\/h2>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Install Required Dependencies<\/h4>\n<pre><code>sudo apt install -y apt-transport-https ca-certificates curl software-properties-common gnupg lsb-release<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Add Docker’s Official GPG Key (2025 Method)<\/h4>\n<pre><code>sudo mkdir -p \/etc\/apt\/keyrings\ncurl -fsSL https:\/\/download.docker.com\/linux\/ubuntu\/gpg | sudo gpg --dearmor -o \/etc\/apt\/keyrings\/docker.gpg\nsudo chmod a+r \/etc\/apt\/keyrings\/docker.gpg<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Add Docker Repository with Dynamic Detection<\/h4>\n<pre><code>echo \"deb [arch=$(dpkg --print-architecture) signed-by=\/etc\/apt\/keyrings\/docker.gpg] https:\/\/download.docker.com\/linux\/ubuntu $(. \/etc\/os-release && echo \"$VERSION_CODENAME\") stable\" | sudo tee \/etc\/apt\/sources.list.d\/docker.list > \/dev\/null<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Install Docker Engine with All Components<\/h4>\n<pre><code>sudo apt update\nsudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Verify Installation<\/h4>\n<pre><code>docker --version\nsudo systemctl status docker<\/code><\/pre>\n<\/div>\n<h2>\ud83d\udcc1 Step 3: Prepare n8n Data Directory<\/h2>\n<pre><code>mkdir -p ~\/.n8n\nsudo chown -R 1000:1000 ~\/.n8n\nsudo chmod -R 755 ~\/.n8n<\/code><\/pre>\n<div class=\"info\">\n<strong>Why UID 1000?<\/strong> The n8n Docker container runs with user ID 1000 by default. Setting ownership to 1000:1000 ensures proper file permissions.<\/div>\n<h2>\ud83d\ude80 Step 4: Deploy n8n Container with Proper Configuration<\/h2>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Pull n8n Image<\/h4>\n<pre><code>docker pull n8nio\/n8n<\/code><\/pre>\n<\/div>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Run n8n Container with Auto-Restart<\/h4>\n<pre><code>docker run -d \\\n --name n8n \\\n --restart unless-stopped \\\n -p 5678:5678 \\\n -v ~\/.n8n:\/home\/node\/.n8n \\\n n8nio\/n8n<\/code><\/pre>\n<\/div>\n<div class=\"success\">\n<strong>\u2705 Improvement:<\/strong> The restart policy is now set directly in the initial command, eliminating the need for a separate <code>docker update<\/code> step.<\/div>\n<h2>\ud83c\udf10 Step 5: Access Your n8n Instance<\/h2>\n<p>Visit: <code>http:\/\/YOUR_SERVER_IP:5678<\/code> (replace with your actual VPS IP address)<\/p>\n<div class=\"warning\">\n<strong>\u26a0\ufe0f Security Note:<\/strong> This HTTP setup is only for initial testing. Follow the SSL configuration steps below for production use.<\/div>\n<h2>\ud83d\udd12 SSL Configuration for Production Use<\/h2>\n<p>You have two options for SSL configuration. <strong>Option 1 is strongly recommended<\/strong> for production environments.<\/p>\n<h3>\ud83c\udfaf Option 1: Nginx Reverse Proxy with Certbot (Recommended)<\/h3>\n<h4>1. Install Nginx<\/h4>\n<pre><code>sudo apt install -y nginx<\/code><\/pre>\n<h4>2. Create Enhanced Nginx Configuration with WebSocket Support<\/h4>\n<pre><code>sudo nano \/etc\/nginx\/sites-available\/n8n<\/code><\/pre>\n<p>Paste the following configuration (replace <code class=\"highlight\">n8n.yourdomain.com<\/code> with your actual domain):<\/p>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Complete Nginx Configuration<\/h4>\n<pre><code># WebSocket upgrade mapping\nmap $http_upgrade $connection_upgrade {\n default upgrade;\n '' close;\n}\n\nserver {\n listen 80;\n server_name n8n.yourdomain.com;\n\n # Security headers\n add_header X-Frame-Options \"SAMEORIGIN\" always;\n add_header X-XSS-Protection \"1; mode=block\" always;\n add_header X-Content-Type-Options \"nosniff\" always;\n\n location \/ {\n proxy_pass http:\/\/localhost:5678;\n proxy_http_version 1.1;\n \n # WebSocket support (CRITICAL for n8n)\n proxy_set_header Upgrade $http_upgrade;\n proxy_set_header Connection $connection_upgrade;\n \n # Standard proxy headers\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header X-Forwarded-Proto $scheme;\n proxy_set_header X-Forwarded-Host $host;\n proxy_set_header X-Forwarded-Port $server_port;\n \n # WebSocket and performance settings\n proxy_cache_bypass $http_upgrade;\n proxy_buffering off;\n proxy_cache off;\n chunked_transfer_encoding off;\n \n # Timeouts for WebSocket connections\n proxy_connect_timeout 7d;\n proxy_send_timeout 7d;\n proxy_read_timeout 7d;\n }\n}<\/code><\/pre>\n<\/div>\n<div class=\"info\">\n<strong>\ud83d\udd27 Critical Enhancement:<\/strong> This configuration includes proper WebSocket support with upgrade mapping, which is essential for n8n’s real-time features like workflow execution monitoring.<\/div>\n<h4>3. Enable and Test Configuration<\/h4>\n<pre><code>sudo ln -s \/etc\/nginx\/sites-available\/n8n \/etc\/nginx\/sites-enabled\/\nsudo nginx -t\nsudo systemctl restart nginx<\/code><\/pre>\n<h4>4. Install Certbot and Obtain SSL Certificate<\/h4>\n<pre><code>sudo apt install -y certbot python3-certbot-nginx\nsudo certbot --nginx -d n8n.yourdomain.com<\/code><\/pre>\n<h4>5. Verify HTTPS Setup<\/h4>\n<p>Access your secure n8n instance at: <code>https:\/\/n8n.yourdomain.com<\/code><\/p>\n<h4>6. Verify Auto-Renewal<\/h4>\n<pre><code>sudo systemctl list-timers | grep certbot\nsudo certbot renew --dry-run<\/code><\/pre>\n<div class=\"success\">\n<strong>\u2705 Automatic Renewal:<\/strong> Certbot automatically configures certificate renewal. No manual intervention required.<\/div>\n<h3>\u2699\ufe0f Option 2: Direct Docker SSL Configuration (Advanced Users)<\/h3>\n<div class=\"warning\">\n<strong>\u26a0\ufe0f Manual Certificate Management Required:<\/strong> This option requires you to handle certificate renewals manually. Only recommended for advanced users with specific requirements.<\/div>\n<h4>1. Prepare Certificate Directory<\/h4>\n<pre><code>mkdir -p ~\/n8n\/certificates\n# Place your certificate files:\n# ~\/n8n\/certificates\/cert.pem (full certificate chain)\n# ~\/n8n\/certificates\/privkey.pem (private key)<\/code><\/pre>\n<h4>2. Stop Existing Container<\/h4>\n<pre><code>docker stop n8n\ndocker rm n8n<\/code><\/pre>\n<h4>3. Run n8n with SSL Configuration<\/h4>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Corrected SSL Docker Command<\/h4>\n<pre><code>docker run -d \\\n --name n8n \\\n --restart unless-stopped \\\n -p 443:5678 \\\n -v ~\/.n8n:\/home\/node\/.n8n \\\n -v ~\/n8n\/certificates:\/certs \\\n -e N8N_HOST=\"n8n.yourdomain.com\" \\\n -e N8N_PORT=5678 \\\n -e N8N_PROTOCOL=https \\\n -e WEBHOOK_URL=\"https:\/\/n8n.yourdomain.com\/\" \\\n -e N8N_SSL_CERT_FILE=\"\/certs\/cert.pem\" \\\n -e N8N_SSL_KEY_FILE=\"\/certs\/privkey.pem\" \\\n n8nio\/n8n<\/code><\/pre>\n<\/div>\n<div class=\"success\">\n<strong>\u2705 Fixed Configuration:<\/strong> This corrected version uses file-based certificates with proper volume mounting and includes all required environment variables.<\/div>\n<h2>\ud83d\udd27 Important Configuration Notes<\/h2>\n<div class=\"info\">\n<strong>WebSocket Support:<\/strong> n8n requires WebSocket connections for real-time workflow execution monitoring. The Nginx configuration above includes proper WebSocket upgrade handling, which is critical for full functionality.<\/div>\n<div class=\"info\">\n<strong>Firewall Configuration:<\/strong> Ensure your VPS firewall allows traffic on:<\/p>\n<ul>\n<li>Port 80 (HTTP) – for initial setup and Certbot verification<\/li>\n<li>Port 443 (HTTPS) – for secure access<\/li>\n<li>Port 22 (SSH) – for server management<\/li>\n<\/ul>\n<\/div>\n<h2>\ud83d\udee0\ufe0f Troubleshooting Common Issues<\/h2>\n<h3>Docker Permission Issues<\/h3>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Add User to Docker Group<\/h4>\n<pre><code>sudo usermod -aG docker $USER\nnewgrp docker\n# or logout and login again<\/code><\/pre>\n<\/div>\n<h3>n8n Data Directory Permissions<\/h3>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Fix Permission Issues<\/h4>\n<pre><code>sudo chown -R 1000:1000 ~\/.n8n\nsudo chmod -R 755 ~\/.n8n<\/code><\/pre>\n<\/div>\n<h3>WebSocket Connection Issues<\/h3>\n<p>If workflows don’t update in real-time:<\/p>\n<ol>\n<li>Verify Nginx configuration includes WebSocket upgrade mapping<\/li>\n<li>Check that proxy headers are properly configured<\/li>\n<li>Ensure no firewall is blocking WebSocket connections<\/li>\n<\/ol>\n<h3>SSL Certificate Issues<\/h3>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Check Certificate Status<\/h4>\n<pre><code>sudo certbot certificates\nsudo certbot renew --dry-run<\/code><\/pre>\n<\/div>\n<h2>\ud83d\udcca Container Management Commands<\/h2>\n<div class=\"command-block\">\n<h4 class=\"command-title\">Essential Docker Commands for n8n<\/h4>\n<pre><code># View container status\ndocker ps -a\n\n# View container logs\ndocker logs n8n\n\n# Follow logs in real-time\ndocker logs -f n8n\n\n# Restart container\ndocker restart n8n\n\n# Update n8n to latest version\ndocker pull n8nio\/n8n\ndocker stop n8n\ndocker rm n8n\n# Then run the docker run command again\n\n# Backup n8n data\ntar -czf n8n-backup-$(date +%Y%m%d).tar.gz ~\/.n8n<\/code><\/pre>\n<\/div>\n<h2>\ud83d\udd10 Security Recommendations<\/h2>\n<ul>\n<li><strong>Use Option 1 (Nginx + Certbot)<\/strong> for automatic SSL certificate management<\/li>\n<li><strong>Configure firewall rules<\/strong> to only allow necessary ports (22, 80, 443)<\/li>\n<li><strong>Regular backups<\/strong> of the <code>~\/.n8n<\/code> directory containing workflows and credentials<\/li>\n<li><strong>Keep Docker and n8n updated<\/strong> to the latest versions for security patches<\/li>\n<li><strong>Use strong passwords<\/strong> and enable two-factor authentication when available<\/li>\n<li><strong>Monitor logs regularly<\/strong> for any suspicious activity<\/li>\n<\/ul>\n<h2>\ud83d\udcda Additional Resources<\/h2>\n<ul>\n<li><a href=\"https:\/\/docs.n8n.io\/\" target=\"_blank\">Official n8n Documentation<\/a><\/li>\n<li><a href=\"https:\/\/docs.docker.com\/engine\/install\/ubuntu\/\" target=\"_blank\">Docker Installation Guide<\/a><\/li>\n<li><a href=\"https:\/\/nginx.org\/en\/docs\/\" target=\"_blank\">Nginx Documentation<\/a><\/li>\n<li><a href=\"https:\/\/certbot.eff.org\/\" target=\"_blank\">Certbot Documentation<\/a><\/li>\n<li><a href=\"https:\/\/community.n8n.io\/\" target=\"_blank\">n8n Community Forum<\/a><\/li>\n<\/ul>\n<div class=\"success\">\n<strong>\ud83c\udf89 Setup Complete!<\/strong> Your n8n instance is now ready for production use with proper SSL configuration, WebSocket support, and automatic certificate renewal. Happy automating!<\/div>\n<p><\/body><br \/>\n<\/html><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The Easiest Way to Install n8n on Ubuntu 22.04 VPS, A step-by-step guide<\/p>\n","protected":false},"author":1,"featured_media":783,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[7],"tags":[23],"class_list":["post-429","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tech","tag-tech"],"yoast_head":"\n<title>How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal\" \/>\n<meta property=\"og:description\" content=\"The Easiest Way to Install n8n on Ubuntu 22.04 VPS, A step-by-step guide\" \/>\n<meta property=\"og:url\" content=\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\" \/>\n<meta property=\"og:site_name\" content=\"Virtual Homelab Portal\" \/>\n<meta property=\"article:published_time\" content=\"2025-06-19T06:17:57+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-07-26T19:48:51+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\" \/>\n\t<meta property=\"og:image:width\" content=\"1024\" \/>\n\t<meta property=\"og:image:height\" content=\"768\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/webp\" \/>\n<meta name=\"author\" content=\"editor@virtualhomelab.win\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"editor@virtualhomelab.win\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\"},\"author\":{\"name\":\"editor@virtualhomelab.win\",\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\"},\"headline\":\"How to Install n8n on a Ubuntu 22.04 VPS\",\"datePublished\":\"2025-06-19T06:17:57+00:00\",\"dateModified\":\"2025-07-26T19:48:51+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\"},\"wordCount\":624,\"publisher\":{\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\"},\"image\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"keywords\":[\"Tech\"],\"articleSection\":[\"Tech\"],\"inLanguage\":\"en-US\"},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\",\"url\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\",\"name\":\"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal\",\"isPartOf\":{\"@id\":\"https:\/\/virtualhomelab.win\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"datePublished\":\"2025-06-19T06:17:57+00:00\",\"dateModified\":\"2025-07-26T19:48:51+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage\",\"url\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"contentUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp\",\"width\":1024,\"height\":768},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/virtualhomelab.win\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"How to Install n8n on a Ubuntu 22.04 VPS\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/virtualhomelab.win\/#website\",\"url\":\"https:\/\/virtualhomelab.win\/\",\"name\":\"Virtual Homelab Protal\",\"description\":\"WordPress site about Technology, current events and Games\",\"publisher\":{\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/virtualhomelab.win\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0\",\"name\":\"editor@virtualhomelab.win\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp\",\"contentUrl\":\"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp\",\"width\":1205,\"height\":310,\"caption\":\"editor@virtualhomelab.win\"},\"logo\":{\"@id\":\"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/\"},\"sameAs\":[\"https:\/\/virtualhomelab.win\"],\"url\":\"https:\/\/virtualhomelab.win\/index.php\/author\/b8434cdcbaa800a6\/\"}]}<\/script>\n","yoast_head_json":{"title":"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","og_locale":"en_US","og_type":"article","og_title":"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal","og_description":"The Easiest Way to Install n8n on Ubuntu 22.04 VPS, A step-by-step guide","og_url":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","og_site_name":"Virtual Homelab Portal","article_published_time":"2025-06-19T06:17:57+00:00","article_modified_time":"2025-07-26T19:48:51+00:00","og_image":[{"width":1024,"height":768,"url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","type":"image\/webp"}],"author":"editor@virtualhomelab.win","twitter_card":"summary_large_image","twitter_misc":{"Written by":"editor@virtualhomelab.win","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#article","isPartOf":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/"},"author":{"name":"editor@virtualhomelab.win","@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0"},"headline":"How to Install n8n on a Ubuntu 22.04 VPS","datePublished":"2025-06-19T06:17:57+00:00","dateModified":"2025-07-26T19:48:51+00:00","mainEntityOfPage":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/"},"wordCount":624,"publisher":{"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0"},"image":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage"},"thumbnailUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","keywords":["Tech"],"articleSection":["Tech"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","url":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/","name":"How to Install n8n on a Ubuntu 22.04 VPS - Virtual Homelab Portal","isPartOf":{"@id":"https:\/\/virtualhomelab.win\/#website"},"primaryImageOfPage":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage"},"image":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage"},"thumbnailUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","datePublished":"2025-06-19T06:17:57+00:00","dateModified":"2025-07-26T19:48:51+00:00","breadcrumb":{"@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#primaryimage","url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","contentUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","width":1024,"height":768},{"@type":"BreadcrumbList","@id":"https:\/\/virtualhomelab.win\/index.php\/2025\/06\/19\/how-to-install-n8n-on-ubuntu-22-04-vps\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/virtualhomelab.win\/"},{"@type":"ListItem","position":2,"name":"How to Install n8n on a Ubuntu 22.04 VPS"}]},{"@type":"WebSite","@id":"https:\/\/virtualhomelab.win\/#website","url":"https:\/\/virtualhomelab.win\/","name":"Virtual Homelab Protal","description":"WordPress site about Technology, current events and Games","publisher":{"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/virtualhomelab.win\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":["Person","Organization"],"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/187852797e216e7bf786ba1c8e56aab0","name":"editor@virtualhomelab.win","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/","url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp","contentUrl":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/virtualhomelab-logo.webp","width":1205,"height":310,"caption":"editor@virtualhomelab.win"},"logo":{"@id":"https:\/\/virtualhomelab.win\/#\/schema\/person\/image\/"},"sameAs":["https:\/\/virtualhomelab.win"],"url":"https:\/\/virtualhomelab.win\/index.php\/author\/b8434cdcbaa800a6\/"}]}},"jetpack_featured_media_url":"https:\/\/virtualhomelab.win\/wp-content\/uploads\/2025\/06\/install-n8n-on-a-vps.webp","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts\/429","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/comments?post=429"}],"version-history":[{"count":20,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts\/429\/revisions"}],"predecessor-version":[{"id":1009,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/posts\/429\/revisions\/1009"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/media\/783"}],"wp:attachment":[{"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/media?parent=429"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/categories?post=429"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/virtualhomelab.win\/index.php\/wp-json\/wp\/v2\/tags?post=429"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}