apertodns 1.1.0 → 1.2.0

package/README.md

@@ -1,6 +1,7 @@
 # ApertoDNS CLI
 
 [![npm version](https://img.shields.io/npm/v/apertodns.svg)](https://www.npmjs.com/package/apertodns)
+[![npm downloads](https://img.shields.io/npm/dm/apertodns.svg)](https://www.npmjs.com/package/apertodns)
 [![license](https://img.shields.io/npm/l/apertodns.svg)](https://github.com/1r0n3d3v3l0per/apertodns/blob/main/LICENSE)
 [![node](https://img.shields.io/node/v/apertodns.svg)](https://nodejs.org)
 
@@ -8,6 +9,19 @@
 
 ApertoDNS is a free Dynamic DNS service that lets you point a subdomain to your dynamic IP address. Perfect for home servers, IoT devices, game servers, NAS systems, and remote access.
 
+## Why ApertoDNS?
+
+| Feature | ApertoDNS | No-IP | DuckDNS | Dynu |
+|---------|-----------|-------|---------|------|
+| Free subdomains | Unlimited | 1 (free) | 5 | 4 |
+| API Keys with scopes | Yes | No | No | Limited |
+| CLI tool | Yes | No | No | No |
+| IPv6 support | Yes | Paid | Yes | Yes |
+| No forced renewal | Yes | 30 days | Yes | Yes |
+| DynDNS2 compatible | Yes | Yes | No | Yes |
+| Webhooks | Yes | No | No | No |
+| Team sharing | Yes | No | No | No |
+
 ## Features
 
 - **Easy Setup** - Login or register directly from CLI
@@ -28,7 +42,14 @@ ApertoDNS is a free Dynamic DNS service that lets you point a subdomain to your
 ## Installation
 
 ```bash
+# npm
 npm install -g apertodns
+
+# yarn
+yarn global add apertodns
+
+# pnpm
+pnpm add -g apertodns
 ```
 
 Or use without installing:
@@ -204,6 +225,52 @@ Configuration is stored in platform-specific locations:
 - **macOS**: `~/.config/apertodns/`
 - **Windows**: `%APPDATA%\apertodns\`
 
+## Troubleshooting
+
+### Common Issues
+
+**"Unable to detect IP address"**
+- Check your internet connection
+- Try a different IP detection service: the CLI automatically tries multiple fallbacks
+- If behind a corporate proxy, the detected IP may be the proxy's IP
+
+**"Authentication failed"**
+- Run `apertodns --logout` then `apertodns --setup` to re-authenticate
+- If using API key, verify it has the required scopes
+- Check if the token/API key is still active in your dashboard
+
+**"DNS not updating"**
+- Use `apertodns --force` to force an immediate update
+- Check `apertodns --status` to see current IP vs DNS IP
+- DNS propagation can take up to 5 minutes
+
+**IPv6 not working**
+- IPv6 requires your ISP and network to support it
+- Use `apertodns --my-ip --json` to check if IPv6 is detected
+- Some networks only provide IPv4
+
+**Permission denied on Linux**
+- If installed globally, you may need sudo: `sudo npm install -g apertodns`
+- Or use a Node version manager (nvm) to avoid permission issues
+
+**Daemon mode exits unexpectedly**
+- Check logs in `/var/log/apertodns.log` if using cron
+- Ensure stable internet connection
+- Consider using a process manager like PM2 or systemd
+
+### Getting Help
+
+```bash
+# Show all commands
+apertodns --help
+
+# Check current status
+apertodns --status
+
+# Verify authentication
+apertodns --verify
+```
+
 ## Security
 
 - Credentials are stored locally, never transmitted except to ApertoDNS servers

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apertodns",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "ApertoDNS CLI - Dynamic DNS management from your terminal. Manage domains, tokens, API keys and DNS updates with style.",
   "main": "index.js",
   "type": "module",