caerostris/tier2

[discontinued] Unofficial HTML5/JS web admin interface for ZeroTier root nodes.

Tier 2

A simple HTML5/JS admin interface for ZeroTier root nodes.
It's kind of the open source, stripped down version of https://my.zerotier.net for anyone wanting to run their own root servers / root topology / world / whatever funky term they'll come up with on the next release.
Please note this is still in pretty early stages. It's more user friendly than bare CURL. Slightly.

Requirements

• ZeroTierOne with Network Controller support (read below!)
• Nginx / Apache
• HTTPS certificate

Setup

The setup is fairly straightforward.

1. Install & update Nginx or Apache configuration from config/
2. Move everything in html/ into your web root (/var/www/html by default)
3. Yay!

Screenshots

Have a look at docs/screenshots

ZeroTier Network Controller Support

The standard distribution of ZeroTier cannot function as a Network Controller.
Thus, Tier2 is not going to work with it. It will give 404 errors.
In order to enable Network Controller Support, you need to download & compile ZeroTier from source with the ZT_ENABLE_NETWORK_CONTROLLER option set to 1.
This can be done as follows:

git clone https://github.com/zerotier/ZeroTierOne.git
cd ZeroTierOne
make ZT_ENABLE_NETWORK_CONTROLLER
make installer # on linux
make mac-dist-pkg # on mac

Now install the generated binary or package.

FAQ

• But why do I need an HTTPS certificate?
  • Let's Encrypt now issues free certificates, you've got no excuse.
• But is it secure to just use the API secret as password?
  • It's not ideal, but kinda secure unless you disable HTTPS.
• Thanks for doing this!
  • Don't worry, I'm just procrastinating. I should be revising.
• I already have Nginx running. Can I run this from a sub-directory?
  • Should work, even though I haven't tested it. You'll have to integrate the config files in config/ into your current config
• I don't like the theme. Can I change it?
  1. You should like it, because it looks cool
  2. Yep, just find a better bootstrap theme (good luck!), place it in the css/ folder and replace the theme in index.html and network.html. You should also update css/zt_network.css.
• How about Apache?
  1. @mcondarelli has provided Apache configs. I added TLS directives but I have not personally tested the modified configuration file. It's not my fault if that config formats your hard drive. You have been warned.

TODO

• Show loading indicators while loading stuff (opening pages and saving settings)
• Proper login with user/password
• Refactor JavaScript view code to be less crappy
• Error handling

License

MPLv2

tier2's Issues

Trouble with javascript console login

Screenshots because I don't really know javascript

[edit: screenshot removed]

but that is right, right? I mean, I sure think it's right. Thanks a bunch. After I entered the token I get a 404 despite this mystery:

[edit: screenshot removed]

As in: The API redirect thing you've got going seems to be up and working fine, but I'm still having issues nonetheless. I'm just going to try replacing /html briefly and see if by some chance I misconfigured.... ???!!!!

Got the SSL cert in place as you requested.....

Apache 2.4 config

FYI: this apache config works for me (files in /var/www/zerotier/html, of course)

<VirtualHost *:80>
  ServerName zerotier.domain.my

  ServerAdmin webmaster@localhost
  DocumentRoot /var/www/zerotier/html

  <Directory "/var/www/zerotier/html">
    Require all granted
  </Directory>

  <Location /api>
    ProxyPass http://127.0.0.1:9993
  </Location>

  LogLevel debug

  ErrorLog ${APACHE_LOG_DIR}/zerotier.error.log
  CustomLog ${APACHE_LOG_DIR}/zerotier.access.log combined

</VirtualHost>

Many Thanks !

1.1.6 controller API changes break Tier2

The controller API was slightly changed in zerotier version 1.1.6, see also
zerotier/ZeroTierOne#344
and
pandada8/zt-panel#3

Tier2 is therefore no longer able to show and edit network details.