Skip to content

Add DNS support to documentation #6

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add DNS support to documentation #6

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,7 @@ ZeroNet counts with a build-in SQL database. This makes content-heavy site devel
* Password-less [BIP32](https://github.com/bitcoin/bips/blob/master/bip-0032.mediawiki)
based authorization: Your account is protected by same cryptography as your bitcoin wallet.
* Namecoin .bit domains support.
* DNS support
* SQL Database support: Allows for easier site development and faster page load times.
* Automatic, uPnP port opening using.
* Plugin for multiuser(openproxy) support.
Expand Down
2 changes: 1 addition & 1 deletion docs/site_development/content_json.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,7 @@ Description of your site, displayed under site title on ZeroHello.

### domain

Namecoin domain name of your site. ZeroHello will link to this if the user has Zeroname plugin enabled.
Domain name of your site. ZeroHello will link to this if the user has Zeroname plugin enabled.

**Example**: Blog.ZeroNetwork.bit

Expand Down
59 changes: 59 additions & 0 deletions docs/using_zeronet/create_new_site.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,5 +50,64 @@ Site:13DNDk..bhC2 Successfuly published to 3 peers
* That's it! You've successfully signed and published your modifications.
* Your site will be accessible from: ```http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2```

### 4. Add domain name resolving

This step is optional. It's hard to use alway a full site ID `13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2`. For this reason it's possible to use a name resolving service. It's possible to use the normal Domain Name System (DNS) or to use the Namecoin system.

To make the homepage (ZeroHello) link to your site domain you have to add a "domain" key to your site's content.json file, for example:

```
{
"address": "1TaLk3zM7ZRskJvrh3ZNCDVGXvkJusPKQ",
"background-color": "#F5F5F5",
"description": "Decentralized forum demo",
"domain": "Talk.ZeroNetwork.bit",
"files": {
...
```

#### Domain Name System (DNS)

Simply add a new TXT record to your DNS zonefile on your nameservers.

##### Example TXT record: Subdomain

```
subdomain IN TXT "zero=1TaLk3zM7ZRskJvrh3ZNCDVGXvkJusPKQ"
```

##### Example TXT record: Top level domain (TLD)

```
@ IN TXT "zero=1TaLk3zM7ZRskJvrh3ZNCDVGXvkJusPKQ"
```

#### Namecoin

To register the site ID just add 'zeronet' key to your namecoin domain.
The "" key means the primary domain, any other than that is a subdomain.

Example:

```
{
"name": {
"formatted": "ZeroNet project"
},
"bitcoin": {
"address": "1QDhxQ6PraUZa21ET5fYUCPgdrwBomnFgX"
},
"zeronet": {
"": "1EU1tbG9oC1A8jz2ouVwGZyQ5asrNsE4Vr",
"blog": "1BLogC9LN4oPDcruNz3qo1ysa133E9AGg8",
"talk": "1TaLk3zM7ZRskJvrh3ZNCDVGXvkJusPKQ"
},
"ns": [
"ns1.domaincoin.net"
"ns2.domaincoin.net"
]
}
```


**Next steps:** [ZeroNet Developer Documentation](/site_development/getting_started/)
6 changes: 3 additions & 3 deletions docs/using_zeronet/installing.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ It will download the latest version of ZeroNet and start it automatically.
### Debian

* `sudo apt-get update`
* `sudo apt-get install msgpack-python python-gevent`
* `sudo apt-get install msgpack-python python-gevent python-dnspython`
* `wget https://github.com/HelloZeroNet/ZeroNet/archive/master.tar.gz`
* `tar xvpfz master.tar.gz`
* `cd ZeroNet-master`
Expand All @@ -35,7 +35,7 @@ It will download the latest version of ZeroNet and start it automatically.

* Check your python version using `python --version` if the returned version is not `Python 2.7.X` then try `python2` or `python2.7` command and use it from now
* `wget https://bootstrap.pypa.io/get-pip.py`
* `python get-pip.py --user gevent msgpack-python`
* `python get-pip.py --user gevent msgpack-python dnspython`
* `wget https://codeload.github.com/HelloZeroNet/ZeroNet/tar.gz/master`
* `tar xvpfz master`
* Start with `python zeronet.py`
Expand All @@ -44,7 +44,7 @@ It will download the latest version of ZeroNet and start it automatically.

* Install [brew](http://brew.sh/)
* `brew install python`
* `pip install gevent msgpack-python`
* `pip install gevent msgpack-python dnspython`
* [Download](https://github.com/HelloZeroNet/ZeroNet/archive/master.zip), Unpack, run `python zeronet.py`

## Vagrant
Expand Down