{"id":5028,"date":"2023-02-11T16:44:55","date_gmt":"2023-02-11T11:14:55","guid":{"rendered":"https:\/\/trysiteprice.com\/blog\/?p=5028"},"modified":"2023-02-11T16:44:55","modified_gmt":"2023-02-11T11:14:55","slug":"nginx-create-http-503-maintenance-custom-page","status":"publish","type":"post","link":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/","title":{"rendered":"nginx: Create HTTP 503 Maintenance Custom Page"},"content":{"rendered":"

You can create a custom 503 maintenance page in Nginx by using the error_page<\/code> directive and creating a custom error page.<\/p>\n

Here’s an example of how you can create a custom 503 maintenance page in Nginx:<\/p>\n

    \n
  1. Create a custom error page file with the desired content, for example 503.html<\/code>. Place it in the root directory of your Nginx server.<\/li>\n<\/ol>\n
    \n
    <\/div>\n
    <!DOCTYPE html<\/span>><\/span>
    \n<html<\/span>><\/span>
    \n<head<\/span>><\/span>
    \n <title<\/span>><\/span>Maintenance Mode<\/title<\/span>><\/span>
    \n<\/head<\/span>><\/span>
    \n<body<\/span>><\/span>
    \n <h1<\/span>><\/span>503 Service Unavailable<\/h1<\/span>><\/span>
    \n <p<\/span>><\/span>Our site is currently under maintenance. Please check back later.<\/p<\/span>><\/span>
    \n<\/body<\/span>><\/span>
    \n<\/html<\/span>><\/span>
    \n<\/code><\/div>\n<\/div>\n
      \n
    1. Add the following lines to the Nginx configuration file (usually \/etc\/nginx\/nginx.conf<\/code>):<\/li>\n<\/ol>\n
      \n
      <\/div>\n
      server {
      \n listen<\/span> 80<\/span>;
      \n server_name yourdomain.com;
      \n root \/var\/www\/yourdomain.com;
      \n index<\/span> index.html;<\/p>\n

      error_page 503<\/span> \/503<\/span>.html;
      \n location = \/503.html {
      \n internal;
      \n }<\/p>\n

      location \/<\/span> {
      \n if<\/span> ($scheme != \"https\"<\/span>) {
      \n return<\/span> 301<\/span> https:\/\/<\/span>$server_name$request_uri;
      \n }<\/p>\n

      proxy_pass http:\/\/<\/span>your_backend;
      \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 }
      \n}
      \n<\/code><\/div>\n<\/div>\n

        \n
      1. When you want to put your site in maintenance mode, set the return code for the root location to 503:<\/li>\n<\/ol>\n
        \n
        <\/div>\n
        server {
        \n listen 80<\/span>;
        \n server_name yourdomain.com;
        \n root \/var<\/span>\/www\/yourdomain.com;
        \n index index.html;<\/p>\n

        error_page 503<\/span> \/503.<\/span>html;
        \n location = \/503.<\/span>html {
        \n internal<\/span>;
        \n }<\/p>\n

        location \/ {
        \n return<\/span> 503<\/span>;
        \n }
        \n}
        \n<\/code><\/div>\n<\/div>\n

          \n
        1. Test the configuration and restart Nginx:<\/li>\n<\/ol>\n
          \n
          <\/div>\n
          nginx -t
          \nsystemctl restart nginx
          \n<\/code><\/div>\n<\/div>\n

          Now, whenever your site is in maintenance mode, visitors will see your custom 503 maintenance page.<\/p>\n

          Note: This example is just one way to create a custom 503 maintenance page in Nginx. Depending on your specific needs, you may need to modify the configuration to suit your requirements.<\/p>\n","protected":false},"excerpt":{"rendered":"

          You can create a custom 503 maintenance page in Nginx by using the error_page directive and creating a custom error page. Here’s an example of how you can create a custom 503 maintenance page in Nginx: Create a custom error page file with the desired content, for example 503.html. Place it in the root directory … Read more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[],"class_list":["post-5028","post","type-post","status-publish","format-standard","hentry","category-best-tutorial"],"yoast_head":"\nnginx: Create HTTP 503 Maintenance Custom Page - TrySitePrice<\/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:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"nginx: Create HTTP 503 Maintenance Custom Page - TrySitePrice\" \/>\n<meta property=\"og:description\" content=\"You can create a custom 503 maintenance page in Nginx by using the error_page directive and creating a custom error page. Here’s an example of how you can create a custom 503 maintenance page in Nginx: Create a custom error page file with the desired content, for example 503.html. Place it in the root directory ... Read more\" \/>\n<meta property=\"og:url\" content=\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/\" \/>\n<meta property=\"og:site_name\" content=\"TrySitePrice\" \/>\n<meta property=\"article:published_time\" content=\"2023-02-11T11:14:55+00:00\" \/>\n<meta name=\"author\" content=\"Rahul Sahu\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/\"},\"author\":{\"name\":\"Rahul Sahu\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/#\/schema\/person\/358e04eeea4281deacad2f30c58e67f4\"},\"headline\":\"nginx: Create HTTP 503 Maintenance Custom Page\",\"datePublished\":\"2023-02-11T11:14:55+00:00\",\"dateModified\":\"2023-02-11T11:14:55+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/\"},\"wordCount\":142,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/trysiteprice.com\/blog\/#organization\"},\"articleSection\":[\"Best\/Tutorial\"],\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/\",\"url\":\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/\",\"name\":\"nginx: Create HTTP 503 Maintenance Custom Page - TrySitePrice\",\"isPartOf\":{\"@id\":\"https:\/\/trysiteprice.com\/blog\/#website\"},\"datePublished\":\"2023-02-11T11:14:55+00:00\",\"dateModified\":\"2023-02-11T11:14:55+00:00\",\"breadcrumb\":{\"@id\":\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/trysiteprice.com\/blog\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"nginx: Create HTTP 503 Maintenance Custom Page\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/#website\",\"url\":\"https:\/\/trysiteprice.com\/blog\/\",\"name\":\"TrySitePrice\",\"description\":\"Free Website Value Calculator Tool\",\"publisher\":{\"@id\":\"https:\/\/trysiteprice.com\/blog\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/trysiteprice.com\/blog\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/#organization\",\"name\":\"TrySitePrice\",\"url\":\"https:\/\/trysiteprice.com\/blog\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/trysiteprice.com\/blog\/wp-content\/uploads\/2021\/12\/cropped-trysiteprice-logo.png\",\"contentUrl\":\"https:\/\/trysiteprice.com\/blog\/wp-content\/uploads\/2021\/12\/cropped-trysiteprice-logo.png\",\"width\":395,\"height\":268,\"caption\":\"TrySitePrice\"},\"image\":{\"@id\":\"https:\/\/trysiteprice.com\/blog\/#\/schema\/logo\/image\/\"}},{\"@type\":\"Person\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/#\/schema\/person\/358e04eeea4281deacad2f30c58e67f4\",\"name\":\"Rahul Sahu\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/trysiteprice.com\/blog\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/51f0f95f7b95665f62baed2211572165?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/51f0f95f7b95665f62baed2211572165?s=96&d=mm&r=g\",\"caption\":\"Rahul Sahu\"},\"sameAs\":[\"https:\/\/trysiteprice.com\/blog\"],\"url\":\"https:\/\/trysiteprice.com\/blog\/author\/rsahu4242_trysiteprice\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"nginx: Create HTTP 503 Maintenance Custom Page - TrySitePrice","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:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/","og_locale":"en_US","og_type":"article","og_title":"nginx: Create HTTP 503 Maintenance Custom Page - TrySitePrice","og_description":"You can create a custom 503 maintenance page in Nginx by using the error_page directive and creating a custom error page. Here’s an example of how you can create a custom 503 maintenance page in Nginx: Create a custom error page file with the desired content, for example 503.html. Place it in the root directory ... Read more","og_url":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/","og_site_name":"TrySitePrice","article_published_time":"2023-02-11T11:14:55+00:00","author":"Rahul Sahu","twitter_card":"summary_large_image","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#article","isPartOf":{"@id":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/"},"author":{"name":"Rahul Sahu","@id":"https:\/\/trysiteprice.com\/blog\/#\/schema\/person\/358e04eeea4281deacad2f30c58e67f4"},"headline":"nginx: Create HTTP 503 Maintenance Custom Page","datePublished":"2023-02-11T11:14:55+00:00","dateModified":"2023-02-11T11:14:55+00:00","mainEntityOfPage":{"@id":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/"},"wordCount":142,"commentCount":0,"publisher":{"@id":"https:\/\/trysiteprice.com\/blog\/#organization"},"articleSection":["Best\/Tutorial"],"inLanguage":"en-US","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/","url":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/","name":"nginx: Create HTTP 503 Maintenance Custom Page - TrySitePrice","isPartOf":{"@id":"https:\/\/trysiteprice.com\/blog\/#website"},"datePublished":"2023-02-11T11:14:55+00:00","dateModified":"2023-02-11T11:14:55+00:00","breadcrumb":{"@id":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/trysiteprice.com\/blog\/nginx-create-http-503-maintenance-custom-page\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/trysiteprice.com\/blog\/"},{"@type":"ListItem","position":2,"name":"nginx: Create HTTP 503 Maintenance Custom Page"}]},{"@type":"WebSite","@id":"https:\/\/trysiteprice.com\/blog\/#website","url":"https:\/\/trysiteprice.com\/blog\/","name":"TrySitePrice","description":"Free Website Value Calculator Tool","publisher":{"@id":"https:\/\/trysiteprice.com\/blog\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/trysiteprice.com\/blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/trysiteprice.com\/blog\/#organization","name":"TrySitePrice","url":"https:\/\/trysiteprice.com\/blog\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/trysiteprice.com\/blog\/#\/schema\/logo\/image\/","url":"https:\/\/trysiteprice.com\/blog\/wp-content\/uploads\/2021\/12\/cropped-trysiteprice-logo.png","contentUrl":"https:\/\/trysiteprice.com\/blog\/wp-content\/uploads\/2021\/12\/cropped-trysiteprice-logo.png","width":395,"height":268,"caption":"TrySitePrice"},"image":{"@id":"https:\/\/trysiteprice.com\/blog\/#\/schema\/logo\/image\/"}},{"@type":"Person","@id":"https:\/\/trysiteprice.com\/blog\/#\/schema\/person\/358e04eeea4281deacad2f30c58e67f4","name":"Rahul Sahu","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/trysiteprice.com\/blog\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/51f0f95f7b95665f62baed2211572165?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/51f0f95f7b95665f62baed2211572165?s=96&d=mm&r=g","caption":"Rahul Sahu"},"sameAs":["https:\/\/trysiteprice.com\/blog"],"url":"https:\/\/trysiteprice.com\/blog\/author\/rsahu4242_trysiteprice\/"}]}},"_links":{"self":[{"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/posts\/5028","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/comments?post=5028"}],"version-history":[{"count":1,"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/posts\/5028\/revisions"}],"predecessor-version":[{"id":5032,"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/posts\/5028\/revisions\/5032"}],"wp:attachment":[{"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/media?parent=5028"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/categories?post=5028"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/trysiteprice.com\/blog\/wp-json\/wp\/v2\/tags?post=5028"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}