Finally a simple interface for domain names https://happydomain.org/
Go to file
Renovate Bot 72ee30ab12
All checks were successful
continuous-integration/drone/push Build is passing
chore(deps): lock file maintenance
2024-06-03 00:16:58 +00:00
actions Add API compatible ddns 2024-05-28 17:22:57 +02:00
admin Refactor session to use gorilla like sessions 2024-05-23 17:29:34 +02:00
api Disallow no-ip/DynDNS updates except through Basic/Bearer Authorization to avoid CSRF 2024-05-28 17:22:57 +02:00
config New option to disable login form (redirect to OIDC) 2024-05-23 17:29:34 +02:00
docs Add screenshots in README 2024-01-30 11:33:43 +01:00
forms Refactor session to use gorilla like sessions 2024-05-23 17:29:34 +02:00
generators Relicense the project to AGPL-3.0 2023-12-24 11:42:00 +01:00
internal auth: Add AuthMethod value in context storing authentication method used 2024-05-28 17:22:57 +02:00
model Refactor session to use gorilla like sessions 2024-05-23 17:29:34 +02:00
providers Refactor session to use gorilla like sessions 2024-05-23 17:29:34 +02:00
services CAA: Handle issuemail (RFC 9495) 2024-02-06 10:31:28 +01:00
storage Refactor session to use gorilla like sessions 2024-05-23 17:29:34 +02:00
ui chore(deps): lock file maintenance 2024-06-03 00:16:58 +00:00
utils chore(deps): update module github.com/happydomain/dnscontrol/v4 to v4.11.100 2024-05-16 20:00:18 +02:00
.dockerignore happydomain is required by Dockerfile-builded 2023-02-25 00:30:33 +01:00
.drone-manifest-local.yml CI/CD: Publish Docker images to local registry 2022-03-15 21:30:17 +01:00
.drone-manifest.yml CD: Deploy on Docker Hub into happydomain organisation 2022-03-22 01:59:49 +01:00
.drone.yml migration to Svelte 4 2024-01-09 10:25:45 +01:00
.gitignore README: Binary has a D capital now 2023-09-15 20:30:47 +02:00
Dockerfile chore(deps): update alpine docker tag to v3.20 2024-05-22 19:10:05 +00:00
Dockerfile-builded chore(deps): update alpine docker tag to v3.20 2024-05-22 19:10:05 +00:00
generate.go Relicense the project to AGPL-3.0 2023-12-24 11:42:00 +01:00
go.mod Use BuildInfo to display version info at start 2024-05-28 16:05:38 +02:00
go.sum Use BuildInfo to display version info at start 2024-05-28 16:05:38 +02:00
hadmin.sh This is happyDomain now 2022-01-18 10:16:32 +01:00
LICENSE Relicense the project to AGPL-3.0 2023-12-24 11:42:00 +01:00
main.go Use BuildInfo to display version info at start 2024-05-28 16:05:38 +02:00
README.md Add screenshots in README 2024-01-30 11:33:43 +01:00
renovate.json renovate: Ignore all releases of github.com/StackExchange/dnscontrol 2023-05-21 10:53:16 +02:00

happyDomain

Finally a simple, modern and open source interface for domain name.

Screenshots of happyDomain

It consists of a HTTP REST API written in Golang (primarily based on https://stackexchange.github.io/dnscontrol/ and https://github.com/miekg/dns) with a nice web interface written with Svelte. It runs as a single stateless Linux binary, backed by a database (currently: LevelDB, more to come soon).

Features:

  • An ultra fast web interface without compromise
  • Multiple domains management
  • Support for 36+ DNS providers (including dynamic DNS, RFC 2136) thanks to DNSControl
  • Support for the most recents resource records thanks to CoreDNS's library
  • Zone editor with a diff view to review the changes before propagation
  • Keep an history of published changes
  • Contextual help
  • Multiple user with authentication or one user without authtication
  • Compatible with external authentication (through JWT tokens: Auth0, ...)

Using Docker

We are a Docker sponsored OSS project! Thus you can easily try and/or deploy our app using Docker/podman/kubernetes/...:

docker run -e HAPPYDOMAIN_NO_AUTH=1 -p 8081:8081 happydomain/happydomain

This command will launch happyDomain in a few seconds, for evaluation purposes (no authentication, volatile storage, ...). With your browser, just go to http://localhost:8081 and enjoy!

In order to deploy happyDomain, check the Docker image documentation.

Building

Dependencies

In order to build the happyDomain project, you'll need the following dependencies:

  • go at least version 1.21;
  • nodejs tested with version 20 and 21.

Instructions

  1. First, you'll need to prepare the frontend, by installing the node modules dependencies:
pushd ui; npm install; popd
  1. Then, generate assets files used by Go code:
go generate ./...
  1. Finaly, build the Go code:
go build -tags listmonk,swagger,ui

This last command will create a binary happyDomain you can use standalone.

Install at home

The binary comes with sane default options to start with. You can simply launch the following command in your terminal:

./happyDomain

After some initialization, it should show you:

Admin listening on ./happydomain.sock
Ready, listening on :8081

Go to http://localhost:8081/ to start using happyDomain.

Database configuration

By default, the LevelDB storage engine is used. You can change the storage engine using the option -storage-engine other-engine.

The help command ./happyDomain -help shows you the available engines:

    -storage-engine value
    	Select the storage engine between [leveldb mysql] (default leveldb)

LevelDB

LevelDB is a small embedded key-value store (as SQLite it doesn't require an additional daemon to work).

    -leveldb-path string
    	Path to the LevelDB Database (default "happydomain.db")

By default, a new directory is created near the binary, called happydomain.db. This directory contains the database used by the program. You can change it to a more meaningful/persistant path.

Persistent configuration

The binary will automatically look for some existing configuration files:

  • ./happydomain.conf in the current directory;
  • $XDG_CONFIG_HOME/happydomain/happydomain.conf;
  • /etc/happydomain.conf.

Only the first file found will be used.

It is also possible to specify a custom path by adding it as argument to the command line:

./happyDomain /etc/happydomain/config

Config file format

Comments line has to begin with #, it is not possible to have comments at the end of a line, by appending # followed by a comment.

Place on each line the name of the config option and the expected value, separated by =. For example:

storage-engine=leveldb
leveldb-path=/var/lib/happydomain/db/

Environment variables

It'll also look for special environment variables, beginning with HAPPYDOMAIN_.

You can achieve the same as the previous example, with the following environment variables:

HAPPYDOMAIN_STORAGE_ENGINE=leveldb
HAPPYDOMAIN_LEVELDB_PATH=/var/lib/happydomain/db/

You just have to replace dash by underscore.

Development environment

If you want to contribute to the frontend, instead of regenerating the frontend assets each time you made a modification (with go generate), you can use the development tools:

In one terminal, run happydomain with the following arguments:

./happyDomain -dev http://127.0.0.1:8080

In another terminal, run the node part:

cd ui; npm run dev

With this setup, static assets integrated inside the go binary will not be used, instead it'll forward all requests for static assets to the node server, that do dynamic reload, etc.