~netlandish/links

LinkTaco is a series of four services (including the API service). For the three link services paid organizations can use their own domains to serve the services.

An example would be to use something like "links.yourdomain.com" instead of "linktaco.com/your-username". The page and data is the same but using your own custom domain has quite some benefits.

#Why use a custom domain?

In our opinion the biggest reason is to "own" your place on the internet. You can always migrate off of LinkTaco to another service or your own link listing by simply changing the DNS records for your custom domain and you're done. You keep your place. That is very important.

Other reasons are organization, easy to remember, vanity, and it just looks cool.

#Setup your custom domains

Each paid organization can have up to three custom domains configured. One for each of the three services that support it.

Each service has it's own CNAME you can point sub domains to. If you are using a sub domain (ie, "sub.domain.com") then configuring your sub domain with a CNAME record is the suggested way to go.

If you want to use a root domain (ie, "domain.com") then you can not set a CNAME and you must use an A record. This is problematic for future cases where we need to move our service(s) to a new IP set, you will also have to update your DNS record for your domain. Of course we will always provide plenty of advance notice should this happen.

Here are the CNAME and IP addresses for each service.

Service CNAME IP Address
Bookmarks links-cname.linktaco.com 174.136.99.171
Link Shortening short-cname.linktaco.com 174.136.99.172
Link Listings list-cname.linktaco.com 174.136.99.173

#Configure LinkTaco for your domains

You will need to add the DNS record(s) to your domain(s) before configuring them in LinkTaco. The system will do a DNS verification check and if it is unable to verify the DNS records are present it will not store the domain configuration for your organization.

If your domains are ready, login to your account and do the following:

  1. On the left menu click "Settings"
  2. In the settings screen click "Manage Organizations"
  3. On the organizations listing, find the organization you want to configure a domain for and click the "Actions" button.
  4. Click the "Domains" option in the drop down menu.
  5. Click the "Add" button in the top right.
  6. Enter the following fields:
  • Name - This is just whatever you want to refer to the domain as. It's only for your own identification purposes.
  • Lookup Name - This is the actual domain name to check. For example, "links.domain.com" or "domain.com".
  • Service - This is the service you want to configure this domain for. The options are Links (aka Bookmarks), Link Shorts (link shortening) and Link Listings.
  1. Click "Save"

The system will do a DNS verification check before actually saving the records. If there is an error you will be notified. Otherwise you will now see the domain listed for the service you selected.

You should be able to load the domain configured in your web browser now. Try typing the domain you setup into your web browser and press enter. The first time connecting it may take a few seconds as the system will need to generate the SSL certificate.

That's it. You're done.

About this wiki

commit 2aac1348afc29af64b6d24324bd435bffb2881d1
Author: Peter Sanchez <peter@netlandish.com>
Date:   2025-02-24T14:03:34-06:00

Fixing anchor name in support doc
Clone this wiki
https://git.code.netlandish.com/~netlandish/links-wiki (read-only)
git@git.code.netlandish.com:~netlandish/links-wiki (read/write)