How to Deploy Static Websites For Free With is a free static web site host which you work together with out of your command line. It makes it fast and simple to get new websites and apps on-line, both manually or as a part of your CI construct course of. Here’s how to get began utilizing the service.

Table of Contents

First Run

We’ll assume you’ve already received a listing of recordsdata you need to deploy to the online. If you haven’t, create a brand new folder, add an index.html, and a few easy starter content material.

Surge’s binary is a JavaScript utility distributed by way of npm. Make positive you’ve got Node.js put in in your system earlier than you proceed. Begin by utilizing npm to set up Surge:

npm set up --global surge

Installing Surge globally means you should use the surge command anyplace, even when your working listing lacks a package deal.json file. Omitting the --global flag will add the package deal as a challenge dependency as a substitute, letting you lock the Surge model used for particular person websites.

Now change listing into your web site’s repository. Run the surge command to begin the deployment course of. A collection of interactive prompts can be displayed, beginning along with your electronic mail tackle to setup a Surge account.

Next, affirm the filesystem path to your challenge. This defaults to your working listing so you possibly can normally press return to proceed.

The following immediate asks for a website identify. A random subdomain is chosen mechanically. You can select a special subdomain, or one in all your personal domains, by coming into it right here. If you’re utilizing your personal area, the next sections clarify how to end setting it up.

After you’ve equipped a website identify, press enter to start the deployment. The progress can be displayed in your terminal because the Surge CLI uploads your recordsdata and makes them accessible on the internet. Visit your area in your browser to see your content material reside!

Site updates are utilized by operating the surge command once more. The contents of your challenge listing can be synced up to your reside web site.

Everything in your folder is uploaded by default. You can exclude particular paths by making a .surgeignore file. This has the identical syntax as .gitignore. Files and folders commonly created by different developer instruments, corresponding to Git and npm, are mechanically omitted.

Using Your Own Domain Name

Surge provides custom domain support by way of CNAME data. This comes at no further value over the usual service. Add a CNAME document in your area supplier’s management panel. Point the @ and www hostnames to Supply your area identify when operating surge to deploy your web site.

You’ll be prompted in your area every time you run the surge command. You can keep away from this by including the --domain flag to surge instructions. Alternatively, create a CNAME file in your challenge listing. Write your area identify into this file.

surge --domain

echo "" > CNAME

Managing HTTPS Redirects

Surge has automated HTTPS help however this doesn’t deal with HTTP to HTTPS redirects by default. Explicitly deploy to the https variant of your area to power all guests to use a secured connection. Enabling redirects is advisable for all publicly accessible web sites.

surge --domain

You’ll want to provide an SSL certificates in case you’re utilizing your personal area. This characteristic is just accessible as a part of the paid Surge Plus plan.

Surge additionally provides you management of naked area to www redirects. The default conduct sees redirect to You can reverse this by explicitly together with the www portion in your deployment area.

surge --domain

Configuring Your Site

Surge provides a number of built-in comfort features which assist it stand out in opposition to different similar platforms. You can add a 404 page, password protection, and CORS support, all utilizing particular recordsdata in your challenge.

The 404 web page is enabled by making a 404.html file. That’s all there may be to it – Surge will serve the file when there’s no direct match for the requested URI.

Password safety is enabled by an AUTH file. This accepts a easy checklist of usernames and passwords.


You’ll be prompted to enter a username and password utilizing HTTP Basic Authentication every time you entry your web site. This characteristic is just accessible on the paid Surge Plus plan.

Another Surge Plus characteristic is guide routing guidelines. You can create a ROUTER file to outline customized redirects, both inside your web site or externally.

301 /moved-page /new-link

Surge helps 301 (moved completely) and 307 (moved briefly) standing codes for the primary column. The final column generally is a relative hyperlink inside your web site, or an absolute hyperlink to one other area (

One ultimate configuration file is CORS. This enables you to allow cross-origin entry to your web site. Add a * to the file to settle for cross-origin requests from any origin. You can write particular person domains as a substitute to restrict the allowed origins.

Automating Surge Deployments

Surge is completely managed by textual content recordsdata and terminal instructions. It’s straightforward to combine into CI pipelines to deploy web sites mechanically on every commit.

Automating Surge requires use of API tokens. This enables you to keep away from the interactive login prompts. First, login to Surge in your growth machine. Run surge token to get your API token.

In your CI pipeline, set the SURGE_LOGIN and SURGE_TOKEN setting variables. The former ought to be your electronic mail tackle whereas the latter takes your API token. Now you possibly can deploy non-interactively utilizing the --project and --domain flags:

surge --project $PWD --domain


Surge makes it easy to get static web sites reside on the internet. The fundamental service is free to use. Upgrading to the Plus plan provides you authentication, redirects and extra configurable HTTPS.

Unlike different contenders, Surge is totally terminal-driven. This makes it very best for fast developer-centric websites managed by way of Git repositories and CI pipelines. It cuts out the server configuration so you possibly can concentrate on constructing your web site’s content material.

For extra superior use instances, Surge even enables you to add a number of contributors. Run surge --add [email protected] to give associates, visitors, and colleagues entry to your web site. They’ll give you the option to deploy by operating surge and supplying the identical area identify you’ve been utilizing.

Source link

This Web site is affiliated with Amazon associates, Clickbank, JVZoo, Sovrn //Commerce, Warrior Plus etc.

Related Posts

Leave a Reply

Your email address will not be published. Required fields are marked *