LINC command line (cli) tools.
The LINC command line tools enable you to run your website on our Front-End Delivery Network (FDN). Installation is easy: simply run
npm i linc-cli -g
to install it on your system. The
-g flag installs it globally.
linc -h will show you the available commands. If a command has subcommands, like
simply add -h to show the options for the subcommand, like so:
linc domain -h
If you're new to LINC, you first need to create an account. In order to do this, simply run
linc user create. You will be asked to enter your email address. If you've already signed
up at some point, you will be shown an error message. Otherwise, you will be shown a welcome
message and your credentials. These credentials are stored in
~/.linc/credentials, but you
should also store them in a secure location, as we cannot recover your credentials. (Should
you ever run into trouble, just send and email to
Once we know who you are, you can start using LINC to deploy your website.
Creating a site
Creating a site is easy too. Just run
linc init in a directory that is set up as an npm
package (meaning that at some point you've run
npm init to create
command will run you through a couple of questions about your site (look at is as a project).
If possible, it will suggest default values based on the values in
instance, the name and description of your site. All questions have sensible defaults, but
make sure to review before submitting. If you make a mistake, simply type Ctrl-C and the
init process will abort immediately.
![alt text]https://cloud.githubusercontent.com/assets/468748/25604335/41db8f4c-2f35-11e7-9bb2-1288f4406013.png "linc init")
![alt text]https://cloud.githubusercontent.com/assets/468748/25604336/41dba518-2f35-11e7-9c55-742315994882.png "linc init")
Once you've entered your sites information and settings, you will be shown the information
that will be added to your
package.json. If you're happy with the settings, simply press
enter (the default is to accept). Otherwise, type
N <enter> or Ctrl-C and start over.
![alt text]https://cloud.githubusercontent.com/assets/468748/25604377/907b1884-2f35-11e7-899c-0292a47ef9aa.png "linc section in package.json")
If you've answered Y, your site will be created in our back-end. This may take a few moments, so be patient. Once this process has finished, some npm packages will be installed automatically, error pages are configured, and example configuration file(s) are copied into your source directory. Finally, if you've added custom domains, your site's endpoint is shown that you need to set up the custom domains with (CNAME).
![alt text]https://cloud.githubusercontent.com/assets/468748/25604337/41edc13a-2f35-11e7-80c2-3d2a0c322947.png "linc init")
Building your site
In order to deploy your site, you first need to build it. Inside your project directory,
linc build. It takes a few moments to finish the build, so please be patient. The
result of the build is a directory called
dist, which contains the information we need
to ultimately deploy your site.
![alt text]https://cloud.githubusercontent.com/assets/468748/25605385/0a5c948c-2f3d-11e7-8636-271d066a9028.png "linc build")
Run your new site locally
You can run your new build using the command
linc serve. It will start a web server on
your machine, listening on port 3000 (
![alt text]https://cloud.githubusercontent.com/assets/468748/25605400/26610d02-2f3d-11e7-95ec-862ea80043f7.png "linc serve")
Deploying your site
In order to actually use your site, you'll need to deploy it. Deploying is as easy as
linc deploy. This will create a zip-file of your
dist directory, and upload it
to our servers. Depending on your internet connection, this may take a few moments. Once
the upload has finished, you will be notified, and your deployment's main information
will be shown. Deployments are unique identified using a so-called deployment key, which is
based on your actual website code, the site name, and the settings that you choose to
use with your site. A deployment URL is shown, which you can use to access the site after
deployment. It may take a few moments for your latest deployment to become available.
![alt text]https://cloud.githubusercontent.com/assets/468748/25605419/3d311d7e-2f3d-11e7-8adb-b09d0e48b8d1.png "linc deploy")
You can add custom domains during initialisation or at a later time. If you haven't added
custom domains during initialisation yet, you can use
linc domain add to add one. This
command will add a custom domain to your site. Also, it will trigger sending an email (or
emails if you have multiple custom domains) to validate an SSL Certificate. Make sure to
validate the SSL Certificate in order to enable a secure connection with your site using
![alt text]https://cloud.githubusercontent.com/assets/468748/25605433/53a1a33a-2f3d-11e7-945f-5f837eb3712a.png "linc domain add")
To see what domains are available for your site, run
linc domain list.
Release a version for your site
Releasing a new version for your site, means coupling a certain deployment (based on its
unique deployment ID) with a custom domain you've added. Simply run
linc release and
answer a few questions: a) the domain(s) to release to and b) which deployment key to use.
![alt text]https://cloud.githubusercontent.com/assets/468748/25605465/852d3a36-2f3d-11e7-908d-1408b22463ec.png "linc release")
Once you've released to a certain custom domain, you can use that domain for your site.
If you want to release again, simply re-run
linc release, and choose a different
Please note that the latest deployment of your site can always be found at the special
Feedback and help
I you run into problems, or have other feedback to give us, feel free to drop us a line