Dual.my Project Documentation

Dark Mode

Introduction

Welcome to the Dual.my Project Documentation! Here you will find detailed information about Dual.my, a free service offering subdomain hosting, static DNS, and dynamic DNS. With our easy-to-use website and API, you can effortlessly control and manage your domain name from anywhere and at any time.


FAQ

Is the domain permanent?
Yes, the domain is permanent. However, it is important to note that our platform has terms of service (TOS) that must be followed. Violating our TOS can lead to termination of the domain, and the decision to terminate is made at our discretion.
How is this service free?
I have carefully designed the architecture of this project to be cost-efficient while providing reliable services and scalability to users around the world. Additionally, the help provided by our community members has made it possible to keep this project free.
What types of DNS records are supported?
We support the following standard record types:
  • NS
  • A
  • AAAA
  • CNAME
  • ALIAS
  • CAA
  • MX
  • TXT
  • More (Coming soon)
Can I use this service for my email?
Yes, but you need your own mail server.
Why can't I add this to Cloudflare?
Currently, we are not included in the public suffix list (PSL). However, if our platform experiences growth and we meet the minimum requirements in terms of domains and users, we will initiate the process of applying for inclusion in the PSL.
What specific user data do you store, and for what purposes?
The only user data Dual.my stores is login and service-related information necessary for providing and maintaining our services. Dual.my does not collect or retain any additional user data beyond what is necessary for these purposes.
Do you sell user data?
Rest assured that your data will be securely stored in our private database and will never be sold.
Can I script my own update?
Yes...
Does Dual.my have an abuse policy?
Yes, we kindly request that you do not abuse our free service and please refer to our Terms of Service and Privacy Policy. We have an in-built system that can detect any abuse. If you have been flagged by mistake, please feel free to reach out to us in our official Discord Group.

Roadmap

  1. Incorporate Custom Domains: Allow users the flexibility to use their own domain names in addition to our provided ones.
  2. Develop Web Forwarding Functionality: Implement a feature that allows users to redirect traffic from one domain to another, enhancing the versatility of our DNS service.
  3. Integrate DNSSEC Support: Increase security by supporting Domain Name System Security Extensions (DNSSEC), which protect against certain types of attacks.
  4. Expand Domain Registry Options: Similar to the model of https://freedns.afraid.org/domain/registry/, include both public and private registry domains to provide a wider variety of options to our users.
  5. Enhance Multi-Language Support: Improve the user interface by adding multi-language support, making the service accessible and convenient for a global user base.
  6. Create More Custom Scripts: Expand our offerings by developing a wider array of custom scripts, further increasing the versatility and customization options available to our users.
  7. Transition to Anycast DNS: Improve performance and increase service speed by transitioning to Anycast DNS, which helps to reduce latency.
  8. List Dual.my Domains on the Public Suffix List: By adding Dual.my domains to the Public Suffix List, we'll enhance compatibility with web browsers and other software that use the list.
  9. Implement Two-Factor Authentication (2FA): For improved security and user account protection, integrate 2FA into the login process. This adds an extra layer of protection against unauthorized access.

By following this roadmap, we aim to make Dual.my an even more powerful, secure, and user-friendly dynamic DNS provider. We welcome feedback and suggestions as we continue to develop and improve our services.


API Documentation

Authentication

All endpoints of the API require an API key for authentication. You can generate your API key at https://dual.my/dashboard.

Rate Limits

The API has a rate limit of 200 requests per 10 minutes. If you exceed this limit, you may experience slower response times or receive error messages.

Endpoints

/update Endpoint

This endpoint is used for managing DNS records of your domain.

Supported Methods

  • GET

Request Parameters

Parameter Description
domains Your domain name
subdomain Additional subdomain for the record (optional)
token Your API key
ip IPv4 address to be set for type "A" record
ipv6 IPv6 address to be set for type "AAAA" record
type Type of DNS record. If not provided, the type will be guessed based on other parameters
value Value for the record type
verbose If provided and set to "yes", the response will contain detailed information
DYN If provided, the client's IP address will be used for "A" or "AAAA" record
TXT Value for TXT record
CNAME A CNAME record maps a domain or subdomain to another domain. However, it cannot coexist with other record types.
ALIAS Similar to a CNAME record, but it can coexist with other records on the same name.
CAA The CAA (Certification Authority Authorization) record specifies which certificate authorities (CAs) are allowed to issue SSL/TLS certificates for a domain. It is used to enhance security and control over certificate issuance.
NS Value for NS record
A IPv4 address to be set for type "A" record
AAAA IPv6 address to be set for type "AAAA" record
MX Value for MX record

Example Request

Here's an example of how to use the /update endpoint to set the "A" record for a specific domain:

Curl
curl -X GET "https://api.dual.my/update?domains=test.xyz.wf&subdomain=optional&token=your_api_key&type=A&value=1.1.1.1&verbose=yes"
Direct Browser
https://api.dual.my/update?domains=test.xyz.wf&subdomain=optional&token=your_api_key&type=A&value=1.1.1.1&verbose=yes

This will set the "A" record for the domain test.xyz.wf with the subdomain optional to the IP address 1.1.1.1. The verbose=yes parameter will include detailed information in the response.

HTTP/HTTPS Support

Dual.my API supports both HTTP and HTTPS, but we recommend using HTTPS for safety.

Dynamic IP Update

One of the unique features of Dual.my API is the ability to automatically update DNS records based on the client's IP address. By providing the "DYN" parameter in the request, the API will determine the record type ("A" or "AAAA") based on the client's IP address. This is especially useful for dynamic DNS scenarios where the client's IP address may change frequently.

Example request for dynamic IP update without any subdomain:

https://api.dual.my/update?domains=dns.xyz.wf&token=your_api_key&DYN

This will set the "A/IPv4" or "AAAA/IPv6" record for the domain dns.xyz.wf to the IP address of the client making the request. The verbose=yes parameter will include detailed information in the response.

Example request for dynamic IP update with subdomain:

https://api.dual.my/update?domains=dns.xyz.wf&subdomain=dino&token=your_api_key&DYN

This will set the "A/IPv4" or "AAAA/IPv6" record for the domain dns.xyz.wf with the subdomain dino to the IP address of the client making the request. The verbose=yes parameter will include detailed information in the response.

Error Codes

Below are some of the error messages that you may encounter while using the API:

  • 401: Invalid API key.
  • 400: Domain not found in the user's domains list.
  • 400: Error: Invalid client IP address.
  • 400: Error: Invalid record type or value. Please check the documentation for more information.
  • 400: User has reached the record limit for this domain.
  • 500: Failed to update record.

/delete Endpoint

This endpoint is used for deleting DNS records of your domain.

Supported Methods

  • GET

Request Parameters

Parameter Description
domains Your domain name
subdomain Additional subdomain for the record (optional)
type Type of DNS record
token Your API key
verbose If provided and set to "yes", the response will contain detailed information

Example Request

Here's an example of how to use the /delete endpoint to delete a specific DNS record:

Curl
curl -X GET "https://api.dual.my/delete?domains=test.xyz.wf&subdomain=optional&type=A&token=your_api_key&verbose=yes"
Direct Browser
https://api.dual.my/delete?domains=test.xyz.wf&subdomain=optional&type=A&token=your_api_key&verbose=yes

This will delete the DNS record of type "A" for the domain test.xyz.wf with the subdomain optional. The verbose=yes parameter will include detailed information in the response.

HTTP/HTTPS Support

Dual.my API supports both HTTP and HTTPS, but we recommend using HTTPS for safety.

Error Codes

Below are some of the error codes that you may encounter while using the API:

  • 401: Invalid API key.
  • 400: Domain not found in the user's domains list.
  • 474: Record not found.
  • 500: Failed to delete record.

Terms of Use

(Last updated 25th June 2023)

Introduction

Welcome to Dual.my, a free dynamic DNS provider that allows you to manage your subdomain, static DNS, and dynamic DNS. This is a free service, subject to change, and it's meant for fair use. Exploiting, spamming, or using the service in an unfair manner is strictly prohibited. Please read these Terms of Service ("TOS") carefully before using our service. By accessing or using Dual.my, you agree to be bound by these terms.

Use of Service

You may use Dual.my's services solely for lawful purposes and in accordance with these TOS. You agree not to use the service in any way that:

  • a. Violates any applicable federal, state, local or international law or regulation;
  • b. Transmits, or procures the sending of, any advertising or promotional material, including any "junk mail," "chain letter," "spam," or any other similar solicitation;
  • c. Impersonates Dual.my, its employees, another user, or any other person or entity;
  • d. Engages in conduct that restricts or inhibits anyone's use or enjoyment of the service, or which, as determined by Dual.my, may harm Dual.my or users of the service or expose them to liability;
  • e. Conducts any illegal activities using the domain or DNS provided by Dual.my;
  • f. Exploits, spams, or uses the service in an unfair manner.

Registration

To use Dual.my's services, you must register and create an account. You agree to provide accurate and complete information during registration. You're responsible for maintaining the confidentiality of your account and password, and you accept responsibility for all activities that occur under your account.

Changes to the TOS

Dual.my reserves the right to modify these Terms of Service (TOS) at any time, without notice. The updated version of the TOS will be indicated by an updated "Last updated" date and the updated version will be effective as soon as it is accessible. Your continued use of the service following any such modification constitutes your agreement to be bound by the modified TOS.

Disclaimer of Warranties

The use of Dual.my's services is at your own risk. The service is provided on an "as is" and "as available" basis without any warranties of any kind, express or implied, including but not limited to the implied warranties of merchantability, fitness for a particular purpose, and non-infringement. Dual.my does not warrant that the service will meet your requirements, be uninterrupted, timely, secure, or error-free, nor does Dual.my make any warranty as to the results that may be obtained from the use of the service or as to the accuracy or reliability of any information obtained through the service. Dual.my does not endorse, warrant, or assume responsibility for any product or service advertised or offered by a third party through the service or any hyperlinked website or featured in any banner or other advertising, and Dual.my will not be a party to or in any way be responsible for monitoring any transaction between you and third-party providers of products or services.
By using Dual.my's services, you acknowledge and agree that any reliance on the service is solely at your own risk. Dual.my shall not be liable for any direct, indirect, incidental, special, or consequential damages arising out of or in any way connected with the use of the service or with the delay or inability to use the service, even if Dual.my has been advised of the possibility of such damages.

Limitation of Liability and Disclaimer

In no event shall Dual.my, nor its owner, employees, partners, agents, developers, or affiliates, be liable for any indirect, incidental, special, consequential or punitive damages, including without limitation, loss of profits, data, use, goodwill, or other intangible losses, resulting from (i) your access to or use of or inability to access or use the service; (ii) any conduct or content of any third party on the service; (iii) any content obtained from the service; and (iv) unauthorized access, use or alteration of your transmissions or content, whether based on warranty, contract, tort (including negligence) or any other legal theory, whether or not we have been informed of the possibility of such damage, and even if a remedy set forth herein is found to have failed of its essential purpose.

Termination

Dual.my may terminate or suspend your account and access to the service at any time, without notice, for any reason.

Indemnification

You agree to indemnify and hold harmless Dual.my, its owner, developers, employees, and agents from any claims, losses, damages, liabilities, including legal fees and expenses, arising out of your use or misuse of Dual.my, your violation of these TOS, or your violation of any rights of a third party or any applicable laws.

Governing Law

These TOS shall be governed by and construed in accordance with the laws of Malaysia. Any legal action arising out of these TOS or the use of the service shall be subject to the jurisdiction of the courts of Malaysia.

Contact Us

If you have any questions or concerns regarding these TOS, feel free to get in touch with us at [email protected].

Thank you for using Dual.my!


Privacy Statement

Introduction

Welcome to Dual.my. We are committed to protecting your personal information and your right to privacy. If you have any questions or concerns about our policy or our practices with regards to your personal information, please contact us at [email protected]

In this privacy policy, we seek to explain to you in the clearest way possible what information we collect, how we use it, and what rights you have in relation to it. We hope you take some time to read through it carefully, as it is important. If there are any terms in this privacy policy that you do not agree with, please discontinue use of our services immediately.

Information We Collect

We collect personal information that you voluntarily provide to us when registering at Dual.my. The personal information that we collect depends on the context of your interactions with us and the service, the choices you make and the features you use. The personal information we collect can include your email and encrypted password for the purpose of providing access to our services. We may also collect non-personal information such as IP addresses, browser types, and device identifiers for analytics and security purposes.

How We Use Your Information

We use personal information collected via our service for a variety of business purposes described below:

  • To provide and maintain our service
  • To manage user accounts
  • To monitor and analyze usage and trends to improve your experience with our service
  • To protect our service
  • For other business purposes, such as data analysis, identifying usage trends, determining the effectiveness of our promotional campaigns, and to evaluate and improve our service.

Data Sharing and Disclosure

We do not share, sell, rent, or trade your information with third parties for their promotional purposes. We may share your information with third-party service providers to perform tasks on our behalf and to assist us in providing our service. Specifically, we employ third-party services such as Cloudflare and Google Analytics for website traffic analysis and user behaviour analytics. These third-party service providers have their own privacy policies addressing how they use such information. You can refer to the following links for their respective privacy policies:

Data Security

We have implemented appropriate technical and organizational security measures designed to protect the security of any personal information we process. However, please also remember that we cannot guarantee that the internet itself is 100% secure. Although we will do our best to protect your personal information, the transmission of personal information to and from our service is at your own risk.

Changes to this Policy

Dual.my reserves the right to modify this Privacy Statement at any time, without notice. The updated version of the Privacy Statement will be indicated by an updated "Last updated" date, and the updated version will become effective as soon as it is accessible. Your continued use of the service following any such modification constitutes your agreement to be bound by the modified Privacy Statement.

Contact Us

If you have questions or comments about this policy, email us at [email protected]