Skip to content

Connect automatically with TransIP

Create a key in your TransIP account, paste it into the dashboard and we'll set up your domain name.

Is your domain name at TransIP? Then you can connect it automatically in about five minutes. You create a key pair at TransIP (a kind of spare key for your DNS settings), paste it into your dashboard and we do the rest.

#What you need

  • Your TransIP login details.
  • Your TransIP username. That's the name you log in with (not necessarily your email address). You'll see it at the top right of the TransIP control panel.
  • Your domain name must use TransIP's DNS. That's the default. Not sure? See Which provider is my domain name with?.

#Step 1: create a key pair at TransIP

  1. Log in to TransIP. Go to transip.eu and log in to the control panel.
  2. Open the API settings. Click your account at the top right, choose Account, then the API tab. (The menu names may be slightly different; look for "API".)
  3. Switch the API on. Is the switch next to API settings still off? Turn it on.
  4. Fill in a label. Under Key pairs, type a recognisable name, for example Switchboard. That way you'll know later what this key is for.
  5. Choose whether to restrict IP addresses. There's a checkbox like Only accept IP addresses from the whitelist. Leave it off and the key works from any address. Turn it on (a bit safer) and add the IP address shown in the dashboard under IP whitelist. It's the same address as in your domain's A record.
  6. Create the key pair. Click Create key pair. You'll now see a long block of text starting with -----BEGIN PRIVATE KEY-----. That's your private key.
  7. Copy the whole key. Select everything, from -----BEGIN up to and including -----END PRIVATE KEY-----, and copy it. TransIP shows this key only once.

#Step 2: paste the key into the dashboard

  1. Open Domains. In your dashboard, go to your website and open Domains. Click Add domain and type your domain name (or pick it if you already added it).
  2. Choose TransIP. Choose to connect automatically and select TransIP.
  3. Fill in your details. Enter your username under TransIP username. Paste the whole key under Private key.
  4. Save. We check right away that the key works, then put the right records in place. You'll see what we did for each record.

After that it usually takes a few minutes until your domain name works. We'll email you as soon as it's ready.

#What we change and what we leave alone

We only change the records your website needs:

  • your domain's A record (and AAAA if needed), pointing to our server;
  • the CNAME record for www, if you connected www too;
  • and, if you switch on Sending email, the records needed for that.

We leave every other record alone. We never change your MX records (they decide where your email arrives), so your mailbox keeps working.

#Security

We store your key encrypted. Want to revoke it? At TransIP, go to Account → API and delete the key pair labelled Switchboard. Your website keeps working; we just can't make changes for you any more. You can also remove the key in the dashboard.

#Not working?

  • "Invalid key": check that you pasted the whole key, including the BEGIN and END lines, and that your username is right.
  • Error about the IP address: you ticked Only accept IP addresses from the whitelist. Add the IP address from the dashboard to the whitelist, or create a new key pair without that box ticked.
  • Domain not found: is the domain name in this TransIP account? And does it use TransIP's name servers?

Still stuck? Choose set it up yourself at TransIP; that always works.

#Next step

Read Checking that your domain works.

Was this helpful?

Guide

Search the guide

Type a word or a question. Tip: press Ctrl K to open this anywhere.