DNS + Web + WebDav server in one package.
- DNS server with catch-all function
- Web server with SSL support (can run many certificates on one IP)
- WebDav for easy upload of files to the web
Parkomat is useful when you have a lot of domains and managing them via typical hosting panel becomes too complex.
Parkomat at the moment doesn't provide pre-built binaries, so you need to have Go installed. Latest version of Go is recommended.
To build, issue:
go get github.com/parkomat/parkomat
You can also update it calling:
go get -u github.com/parkomat/parkomat
As a configuration format Parkomat uses TOML
Note: instead of 127.0.0.1
use your external IP.
# if you set it to true, Parkomat will serve any domain pointing at it
catch_all = true
[[domains]]
name = "example.domain"
[[domains]]
name = "parkomat.io"
# supports per domain zone settings
[domains.zone]
A = "192.168.0.1"
MX = """
1 better.mail.server
"""
TXT = """
hello world
"""
# each domain will use following zone settings
[zone]
# for both .domain and www.domain
A = "127.0.0.1"
MX = '''
1 test1.mail.server
10 test2.mail.server
'''
[web]
ip = "127.0.0.1"
port = 80
path = "./www"
# make sure that path exists
# for example issue mkdir -p /var/log/parkomat
access_log = "/var/log/parkomat/access.log"
[webdav]
enabled = true
username = "hello"
password = "world"
# your share will be under http://example.domain/dav/
mount = "/dav/"
[dns]
ip = "127.0.0.1"
port = 53
# details of dns servers for NS record
[[dns.servers]]
name = "ns1.parkomat.co"
ip = "127.0.0.1"
[[dns.servers]]
name = "ns2.parkomat.co"
ip = "127.0.0.1"
Make sure to create GLUE
record for each dns server listed in [[dns.servers]]
. You need to follow your registrar documentation on how to do it.
You can run multiple parkomat nodes for DNS server. Make sure they use the same configuration file (for example mounted via NFS).
To run parkomat in DNS only mode, use:
./parkomat -dns_only=true -config_file=/path/to/config.toml
You ./web
path could look like this:
.
├── default
│ └── public_html
│ └── index.html
└── parkomat.io
├── parkomat.io.crt
├── parkomat.io.key
└── public_html
└── index.html
To add new domain, simply create new directory with that domain name.
If you want to use SSL, just copy domain.crt
and domain.key
files to that domain directory (be careful - do not upload them to public_html
directory). You need to restart parkomat afterwards (SSL at the moment is not reloaded at runtime).
All your html and other files go to public_html
directory.
If you want to use WebDav with windows, the domain you will be using it with should have certificates uploaded. Apparently WebDav doesn't work without SSL on Windows.
You can use attached supervisord
script as an example.
You can also run it from command line:
./bin/parkomat -logtostderr=true
This will print debug information, useful for troubleshooting
- Better documentation
- API
- Stats
- Mail forwarding
- Live reload of configuration
- ???