vinyldns/portal repository overview

VinylDNS is a vendor agnostic front-end for managing self-service DNS across your DNS systems. The platform provides fine-grained access controls, auditing of all changes, a self-service user interface, secure REST based API, and integration with infrastructure automation tools like Ansible and Terraform. It is designed to integrate with your existing DNS infrastructure, and provides extensibility to fit your installation.

⁠Quickstart

To start playing around with VinylDNS right away, see https://github.com/vinyldns/vinyldns#quickstart⁠ to get a local instance of the API, web client, and a bind9 DNS server with preloaded test zones

⁠Configuration for the vinyldns/portal image

The portal image is configured to run in a docker compose environment locally. To run in a production environment, you would have to configure the portal appropriately using these settings.

⁠Volume mounts

• /opt/docker/lib_extra - place here additional jar files that need to be loaded into the classpath when the application starts up. This is used for "plugins" that are proprietary or not part of the standard build. All jar files here will be placed on the class path.
• /opt/docker/conf/application.conf - to override default configuration settings
• /opt/docker/conf/application.ini - to pass additional JVM options
• /opt/docker/conf/trustStore.jks - to make available a custom trustStore, which has to be set in /opt/docker/conf/application.ini as -Djavax.net.ssl.trustStore=/opt/docker/conf/trustStore.jks

⁠Custom LDAP config

In /opt/docker/conf/application.conf there is a switch for portal.test_login = true. This is set by default so developers can login to the portal with username=testuser and password=testpassword. Custom LDAP settings will have to be set in /opt/docker/conf/application.conf

⁠Configuring a custom Java trustStore

To add a custom Java trustStore, say for LDAP certs, add the trustStore to /opt/docker/conf/trustStore.jks. Then add -Djavax.net.ssl.trustStore=/opt/docker/conf/trustStore.jks to /opt/docker/conf/application.ini.

⁠Additional JVM parameters

Additional JVM parameters can be added to /opt/docker/conf/application.ini

⁠License

Source code for VinylDNS is licensed under Apache-2.0; view license information⁠ for that software contained in this image.

As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).