You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 7-8.RSVP
Socket
Socket
Sign inDemoInstall

daplie-tools

Package Overview
Dependencies
3
Maintainers
7
Versions
27
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

daplie-tools

Taking back the Internet


Version published
Maintainers
7
Created

Readme

Source

About Daplie: We're taking back the Internet!

Down with Google, Apple, and Facebook!

We're re-decentralizing the web and making it read-write again - one home cloud system at a time.

Tired of serving the Empire? Come join the Rebel Alliance:

jobs@daplie.com | Invest in Daplie on Wefunder | Pre-order Cloud, The World's First Home Server for Everyone

Daplie Tools

Taking Back the Internet!

https://daplie.com/articles/introducing-daplie/

That's what we're doing and that's what these tools are for.

What can I do with 'em?

daplie-tools is a CLI suite of tools for managing Internet infrastructure:

  • Manage Domains

    • purchase your own domain
    • transfer from your current registrar
    • get a daplie.me subdomain
  • Manage DNS

    • Glue Records
    • Domain Nameservers
    • Static Record Types (CNAME, MX, SRV, TXT)
    • Device (server) Record Types (A, AAAA)
  • Dynamic DNS (DDNS)

    • Managed with Device API

(NAT automation and Reverse VPN purchase are planned for the future)

Install

This is alpha software (not quite beta yet).

We're intending this to be used by people that are happy to submit to us bug reports and not give up when it doesn't work quite right.

(remember: computers are like people - no two are alike and although it works as expected for everyone else, it will somehow fail for you)

Minimal

# install node.js 4.3 or greater
curl -sL bit.ly/nodejs-min | bash

# install daplie-tools
npm install -g daplie-tools

Note: you will need curl and git installed.

With Development Tools

# install various daplie scripts to /usr/local/bin
curl -sL https://daplie.me/install-scripts | bash

# install node.js 4.3 or greater
daplie-install-node-dev

# install daplie-tools
npm install -g daplie-tools

If you don't want to use the scripts you can always download node.js here: https://nodejs.org/en/download/ (but then you have to fix permissions on /usr/local and perhaps deal with quirks).

Windows

Download and install the node.js installer from https://nodejs.org/en/download/

npm install -g daplie-tools

Windows is not as well tested, but our goal is to make it a first-class citizen, so please open issues for anything that doesn't work as you expect. I just got a Surface Book (yay!) so hopefully I'll find the bugs before you do. We shall see.

Choosing your provider for testing

Use the --provider option to choose which identity issuer and resource audience you will be using: (the default is oauth3.org)

daplie --provider daplie.me domains:list

Walkthroughs & FAQs

Get a daplie.me subdomain

In short, you just enter the purchase console, type the domain you want, and end with .daplie.me:

daplie domains:search

Oh, and you can also script the domain purchase directly:

daplie help domains:search

daplie domains:search --domainnames "example.daplie.me" --tip 1 -max-purchase-price 1

Note: although we don't check right now, excessive use of daplie.me domains will be reclaimed. If you have a large number of users you would like to supply domains for, email aj@daplie.com and I'll help you get your own domain set up for your users.

Purchase your own .com, .org, .net, etc

  1. Open the purchase console
  2. Type the name of the domain you want
  3. If it is not available the price turns into N/A
  4. Follow the prompts once you find an available domain
daplie domains:search

Oh, and you can also script the domain purchase directly:

daplie help domains:search

daplie domains:search --domainnames "example.daplie.me," --tip 1 -max-purchase-price 30

Transfer a Domain

Before you can transfer a domain, there are a few things you need to do through the company you bought it from:

  1. You must TURN OFF WHOIS PRIVACY
  2. You must UNLOCK your domain
  3. You must get an EPP Transfer Code (the name may vary by registrar)
  4. Copy your DNS records (copy and paste, screenshot, csv, whatever they offer)

Note: Usually your DNS records will remain active with your current company for 2 weeks or more, but don't forget to transfer them over.

With the EPP code you can perform the transfer in this format:

daplie domains:search --domainnames 'DOMAIN1:EPP1,DOMAIN2:EPP2'

Example:

daplie domains:search --domainnames 'example.com:^%efea$#!0,example.net:afe187e7cc'
  1. It will take 1-10 days for the transfer to complete
  2. Make sure that you have added your DNS records to our nameservers (See Manage DNS section below)
  3. You must update the nameservers once the transfer completes
  4. Wait anywhere between a few minutes and a few days for the changes to propagate

Example:

# Set the nameservers to Daplie defaults
daplie ns:set -n example.com --defaults

DO NOT DO THIS until you've copied the DNS records over (see the next section Manage DNS)

Or set custom nameservers like this:

# See the help
daplie help ns
daplie help ns:set

# See the current nameservers
daplie ns:list -n example.com

# Set vanity nameservers
daplie ns:set -n example.com --nameservers 'ns1.example.com,ns2.example.com'

Manage DNS with Servers (Digital Ocean, Azure, AWS, etc)

  1. Set IP address to each device (names are arbitrary)
  2. Set the device to corresponding domains
  3. Set non-device records
daplie devices:set --device 'aws-west-1' --addresses '127.0.0.1,::1'

daplie devices:attach --device 'aws-west-1' -n 'example.com'

# Example setting up mailgun
daplie dns:set -n example.com --type MX --answer mxa.mailgun.org --ttl 3600
daplie dns:set -n example.com --type MX --answer mxb.mailgun.org --ttl 3600
daplie dns:set -n mail.example.com --type CNAME --answer mailgun.org --ttl 3600

Note: (ANAME and FWD records are not yet supported)

Dynamic DNS with Raspberry Pi, Router, cron, etc

  1. Set IP address to each device (names are arbitrary)
  2. Set the device to corresponding domains
  3. Set non-device records
daplie devices:set --device 'rpi2' --addresses '127.0.0.1,::1'

daplie devices:attach --device 'rpi2' -n 'example.com'

daplie devices:token --device 'rpi2'

Now schedule cron with a script to check your IP address every 5 minutes or so and then run curl with the url+token if the IP has changed.

Note: (A more comprehensive devices:update method will be implemented soon)

Why do we require a credit card?

Many of the popular free DNS services are blocked by corporate, government, and school firewalls because of abuse from non-paying anonymous users.

In order to ensure that our service remains available to all of our users we require a valid credit card and physical address as a method of deterring abusive and/or malicious users.

White-Label Subdomains and/or Dynamic DNS

You could offer your subdomains to your users in the same way that we offer daplie.me subdomains for our users.

Right now that's a manual process. If you're interested contact aj@daplie.com.

Vanity Nameservers

More often than not, the company that you pay for your domain will set your nameservers automatically to promote their brand, something like: ns1.domainregistrar.com, ns2.domainregistrar.com.

Vanity Nameservers promote your brand instead. So if you own example.com you would want the nameservers ns1.example.com, ns2.example.com, etc.

Right now Daplie Domains uses generically branded nameservers, but we plan to move to completely using Vanity Nameservers before our public launch.

To play with Vanity Nameservers (WARNING: you may experience DNS resolution issues while we are still in development) you can set the nameserver glue records for your domain to us even today:

daplie glue:set -n example.com --defaults

daplie ns:set -n example.com --nameservers 'ns1.example.com,ns2.example.com'

You can, of course, also use your own nameservers too:

Example:

daplie glue:set -n ns1.example.com --address 127.0.0.1
daplie glue:set -n ns2.example.com --address 127.0.0.2

daplie ns:set -n example.com --nameservers 'ns1.example.com,ns2.example.com'

Commands

See COMMANDS.md

Authors

daplie-tools is developed by AJ ONeal.

Versioning

This is an Alpha, so we really just bump the build version.

When it goes into RC is when we'll try to keep all of the command flags the same so that scripts you build won't break.

The format is: v<major.minor.patch>-<class>+<build>

More information is available at http://semver.org/

License

daplie-tools is licensed under the MPLv2 license.

Keywords

FAQs

Package last updated on 09 Jun 2017

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc