{"id":18075009,"url":"https://github.com/lnsp/koala","last_synced_at":"2025-04-12T07:10:34.277Z","repository":{"id":36001899,"uuid":"131425346","full_name":"lnsp/koala","owner":"lnsp","description":"Frontend service for editing DNS zone files","archived":false,"fork":false,"pushed_at":"2023-11-11T00:41:14.000Z","size":4071,"stargazers_count":7,"open_issues_count":7,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-26T02:22:34.892Z","etag":null,"topics":["bind","dns","frontend","golang","user-interface","vue","zones"],"latest_commit_sha":null,"homepage":"","language":"Vue","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lnsp.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"security/security.go","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-28T16:20:35.000Z","updated_at":"2024-12-11T12:32:37.000Z","dependencies_parsed_at":"2024-10-31T10:44:17.483Z","dependency_job_id":"243bf2dd-6e45-4636-b8bd-8e521e4e5172","html_url":"https://github.com/lnsp/koala","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnsp%2Fkoala","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnsp%2Fkoala/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnsp%2Fkoala/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnsp%2Fkoala/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lnsp","download_url":"https://codeload.github.com/lnsp/koala/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248530575,"owners_count":21119600,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bind","dns","frontend","golang","user-interface","vue","zones"],"created_at":"2024-10-31T10:44:09.475Z","updated_at":"2025-04-12T07:10:34.242Z","avatar_url":"https://github.com/lnsp.png","language":"Vue","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Koala\n\nkoala is a simple browser frontend for editing zonefiles and applying the changes made. It supports basic authentication via JWT tokens built-in, usage in a production environment is not yet recommended.\n\n## Dependencies\nkoala requires Go 1.16 and NodeJS 12.X or newer.\n\n## Configuration\n```toml\naddr = \":8081\"          # address the server will be listening on\ndebug = true            # debug mode\ncors = false            # enable cors\napply_cmd = \"sleep 1\"   # command to execute after zonefile change\napi_root = \"/api\"       # path to use for api\n\n[[zones]]\npath = \"zone\"           # zonefile to be edited\norigin = \"home.arpa.\"   # zone to be edited\nttl = 3600              # default TTL\n\n[security]\nmode = \"none\"           # guard to use, either 'none', 'oidc' or 'jwt'\n\n[security.oidc]\nclient_id = \"\"          # OpenID connect client ID\nidentity_server = \"\"    # URL of identity provider\n\n[security.jwt]\nsecret = \"\"             # Auth secret for JWT tokens\n```\n\n## Installation\n**Step 1:** Download one of the binary packages from the release site\n```bash\n# Linux amd64\ncurl -O -L https://github.com/lnsp/koala/releases/latest/download/koala_linux_amd64\n# Linux arm\ncurl -O -L https://github.com/lnsp/koala/releases/latest/download/koala_linux_arm64\n# macOS amd64\ncurl -O -L https://github.com/lnsp/koala/releases/latest/download/koala_darwin_amd64\n```\n\n**Step 2:** Copy binary to bin dir\n```bash\ncp koala_* /usr/local/bin/\n```\n\n**Step 3:** Create configuration folder and customize configuration\n```bash\nmkdir -p /etc/koala\ncp config.toml /etc/koala/config.toml\nnano config.toml\n```\n\n**Step 4:** Install a startup script, you should customize it though. Please remember to\nprotect yourself from unauthorized access.\n```bash\ncat \u003e /etc/systemd/system/koala.service \u003c\u003c EOF\n[Unit]\nDescription=Koala DNS editing frontend\nAfter=network.target\n\n[Service]\nType=simple\nUser=root\nWorkingDirectory=/etc/koala/\nExecStart=/usr/local/bin/koala -config config.toml\nRestart=on-abort\n\n[Install]\nWantedBy=multi-user.target\nEOF\nsystemctl daemon-reload\nsystemctl enable koala\nsystemctl start koala\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnsp%2Fkoala","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flnsp%2Fkoala","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnsp%2Fkoala/lists"}