{"id":20560326,"url":"https://github.com/andreaskoch/dee-cli","last_synced_at":"2025-03-06T07:43:17.496Z","repository":{"id":57578672,"uuid":"50058549","full_name":"andreaskoch/dee-cli","owner":"andreaskoch","description":"Cross-platform command-line utility for DNS updates via DNSimple","archived":false,"fork":false,"pushed_at":"2016-05-26T14:26:57.000Z","size":376,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2025-01-16T19:05:26.024Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/andreaskoch.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-01-20T20:36:07.000Z","updated_at":"2021-07-09T13:46:18.000Z","dependencies_parsed_at":"2022-09-26T19:11:31.997Z","dependency_job_id":null,"html_url":"https://github.com/andreaskoch/dee-cli","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaskoch%2Fdee-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaskoch%2Fdee-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaskoch%2Fdee-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/andreaskoch%2Fdee-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/andreaskoch","download_url":"https://codeload.github.com/andreaskoch/dee-cli/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242168489,"owners_count":20083092,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T03:54:14.079Z","updated_at":"2025-03-06T07:43:17.468Z","avatar_url":"https://github.com/andreaskoch.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dee CLI\n\nUpdate DNS records from the command-line\n\n`dee` is single self-contained command-line utility for updating subdomain records that are managed by DNSimple written go that works on Linux, Mac OS and Windows alike.\n\n[![Build Status](https://travis-ci.org/andreaskoch/dee-cli.svg?branch=master)](https://travis-ci.org/andreaskoch/dee-cli)\n\n## Usage\n\n```bash\ndee \u003caction\u003e [arguments ...]\n```\n\nGet help:\n\n```bash\ndee --help\n```\n\n**Actions**:\n\n- `login` to the DNSimple API\n- `logout`\n- `create` an address record for a given domain\n- `list` all available domain, subdomain and DNS records\n- `update` a given address record by name\n- `delete` a given address record by name\n- `createorupdate` a given address record\n\n### Action: `login`\n\nSave DNSimple API credentials to disc.\n\n**Arguments**:\n\n- `-email`: The e-mail address of your DNSimple account\n- `-apitoken`: The DNSimple API token\n\n**Example**:\n\n```bash\ndee login -email apiuser@example.com -apitoken TracsiflOgympacKoFieC\n```\n\nThe credentials are saved to: `~/.dee/credentials.json`\n\n### Action: `logout`\n\nRemove any stored DNSimple API credentials from disc.\n\n```bash\ndee logout\n```\n\n### Action: `list`\n\nList all available domains or subdomains.\n\n**Arguments**\n\n- `-domain`: A domain name (optional)\n- `-subdomain`: A subdomain name (optional)\n\n**Examples**\n\nList all available domains:\n\n```bash\ndee list\n```\n\nList all subdomain of a given domain:\n\n```bash\ndee list -domain example.com\n```\n\nList all DNS records for a given subdomain:\n\n```bash\ndee list -domain example.com -subdomain www\n```\n\n### Action: `create`\n\nCreate an address record.\n\n**Arguments**:\n\n- `-domain`: A domain name (required)\n- `-subdomain`: The subdomain name (required)\n- `-ip`: An IPv4 or IPv6 address (required)\n- `-ttl`: The time to live (TTL) for the DNS record in seconds (default: 600)\n\n**Examples**:\n\nCreate an `AAAA` record for the subdomain `www`:\n\n```bash\ndee create -domain example.com -subdomain www -ip 2001:0db8:0000:0042:0000:8a2e:0370:7334\n```\n\nCreate an `AAAA` record for the subdomain `www` with TTL of 1 minute:\n\n```bash\ndee create -domain example.com -subdomain www -ip 2001:0db8:0000:0042:0000:8a2e:0370:7334 -ttl 60\n```\n\nCreate an `A` record for the subdomain `www`:\n\n```bash\ndee create -domain example.com -subdomain www -ip 10.2.1.3\n```\n\nThe `-ip` parameter can also be passed via Stdin:\n\n```bash\necho \"2001:0db8:0000:0042:0000:8a2e:0370:7334\" | dee create -domain example.com -subdomain www -ttl 3600\n```\n\n### Action: `delete`\n\nDeletes an address record.\n\n**Arguments**:\n\n- `-domain`: A domain name (required)\n- `-subdomain`: The subdomain name (required)\n- `-type`: The address record type (required, e.g. \"AAAA\", \"A\")\n\n**Examples**:\n\nDelete the IPv6 address record for www.example.com:\n\n```bash\ndee delete -domain example.com -subdomain www -type AAAA\n```\n\nDelete the IPv4 address record for www.example.com:\n\n```bash\ndee delete -domain example.com -subdomain www -type A\n```\n\n### Action: `update`\n\nUpdate the DNS record for a given sub domain\n\n**Arguments**:\n\n- `-domain`: A domain name (e.g. `example.com`)\n- `-subdomain`: A subdomain name (e.g. `www`)\n- `-ip`: An IPv4 or IPv6 address\n\n**Examples**:\n\nSet the `AAAA` record of `www.example.com` to the given IP address:\n\n```bash\ndee update -domain example.com -subdomain www -ip 2001:0db8:0000:0042:0000:8a2e:0370:7334\n```\n\nThe `-ip` address parameter can also be passed in via Stdin:\n\n```bash\necho \"2001:0db8:0000:0042:0000:8a2e:0370:7334\" | dee update -domain example.com -subdomain www\n```\n\n### Action: `createorupdate`\n\nThe create-or-update action can be used if you are not sure if the address record you are trying to update does already exist.\nIf the record exists it will be just updated; if it does not yet exist it will be created with the given IP address.\n\n**Arguments**:\n\n- `-domain`: A domain name (required)\n- `-subdomain`: The subdomain name (required)\n- `-ip`: An IPv4 or IPv6 address (required)\n- `-ttl`: The time to live (TTL) for the DNS record in seconds (default: 600)\n\n## Dependencies\n\ndee uses the [github.com/andreaskoch/dee-ns](https://github.com/andreaskoch/dee-ns) library for creating, reading, updating and delting DNSimple DNS records.\n\n## Installation \u0026 Build\n\nInstall dee-cli using `go get`:\n\n```bash\ngo get -u github.com/andreaskoch/dee-cli\n```\n\nCompile dee-cli yourself:\n\n```bash\ngo get -u github.com/andreaskoch/dee-cli\ncd $GOPATH/github.com/andreaskoch/dee-cli\ngo run make.go -install\n```\n\nCompile the dee binaries for Linux (64bit, ARM, ARM5, ARM6, ARM7), Mac OS (64bit) and Windows (64bit):\n\n```bash\ncd $GOPATH/github.com/andreaskoch/dee-cli\ngo run make.go -crosscompile\n```\n\n## Contribute\n\nIf you find a bug or if you want to add or improve some feature please create an issue or send me a pull requests.\nAll contributions are welcome.\n\nIf you are planning to sign up for [DNSimple](https://dnsimple.com) and if you like this tool I would be happy if you use this link: [https://dnsimple.com/r/381546095cf6a2](https://dnsimple.com/r/381546095cf6a2)\n\nOne month of free service for the both of us :dancers:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreaskoch%2Fdee-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandreaskoch%2Fdee-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandreaskoch%2Fdee-cli/lists"}