jcoffey-dev 5641560a91 Guided wizards, opt-in every time, and automatic DNS as the first
A job that has a wizard now asks "Guide me / I'll do it myself" each time
it starts; nothing is remembered. The shared wizard shell gives every guide
a stepper, a side panel on what each step does and how to undo it, and the
way forward or back.

Automatic DNS, from a domain's DNS section:
- finds where the domain's DNS is hosted from its SOA and NS records, and
  offers that host when the server can drive it;
- for the major hosts, steps to create the narrowest credential, and the
  field named as the steps name it;
- records grouped by what they do, TLSA off unless the zone is signed;
- saves the provider and switches the domain over, removing the provider
  again if the switch fails;
- watches the publishing task and public DNS, ticking each record green,
  and boils a host's refusal down to its distinct messages;
- for hosts it can't drive, or domains not in DNS yet, every record laid
  out for copying, with the same live checks.
2026-09-19 01:41:00 -07:00
2026-08-24 15:44:51 +02:00
2026-08-24 15:44:51 +02:00
2026-04-20 15:02:57 +02:00
2026-04-20 15:02:57 +02:00
2026-09-15 09:27:02 +02:00
2026-04-20 15:02:57 +02:00
2026-04-20 15:02:57 +02:00
2026-04-20 15:02:57 +02:00

inbuxa

INBUXA Admin

The administration interface for the INBUXA mail server: every server setting, first-boot setup, and recovery, in the browser.

It is schema-driven. After signing in it fetches the server's schema and builds every form, list and menu from it, so it covers every setting the server has without hardcoding any of them.

Status: in development, not released.

Design

  • One edition. Every feature the server has is available here, with nothing held back. See the INBUXA server's docs/spec/.
  • Runs anywhere, not on the mail server. INBUXA Admin is its own deployment, never installed onto the mail server. It's pointed at the server either at build time (VITE_API_BASE_URL) or at deploy time: <meta name="api-base-url" content="https://mail.example.com"> in index.html. Hosted like that, it signs in as the OAuth client inbuxa-admin, which the server registers when it's started with INBUXA_ADMIN_URL set to INBUXA Admin's address (for development, http://localhost:5173).
  • INBUXA's look: the logo and ihasmail's palette.
  • Two-factor setup names INBUXA as the issuer, and no longer makes authenticator apps fetch a logo from a third-party site.

Developing

npm ci
npm run dev          # http://localhost:5173, against VITE_API_BASE_URL in .env.development
npm run typecheck && npx eslint src/ && npx vitest run
npm run build

Keeping up with upstream

The upstream codebase's history contains no code under a proprietary license, so this is an ordinary git fork. upstream is a fetch-only remote:

git fetch upstream --tags
git merge v1.0.12        # the next release tag

Versions

INBUXA Admin has its own dated version (inbuxa-version.json), shown with the upstream release it's based on: INBUXA Admin 2026.9.18 (base 1.0.11). package.json keeps upstream's version, so upstream's bumps merge cleanly.

Source code

Every build carries its own source. The interface links to it (the user menu and the sign-in page), and the build writes it next to the app as source.tar.gz: the exact tree the running version was built from.

License and credits

Free software under the GNU Affero General Public License, version 3.

INBUXA Admin is forked from the upstream AGPL-3.0 web administration codebase originally developed by Stalwart Labs. Their copyright notices are kept on every file inherited from it, and INBUXA's own notice is added to the files it changes. Those files are offered upstream under the AGPL-3.0-only or a proprietary license. INBUXA uses them under the AGPL-3.0 only. INBUXA isn't affiliated with or endorsed by Stalwart Labs.

S
Description
Imported from github.com during the 2026-09-20 standup (local dir: inbuxa-admin)
Readme
1.6 MiB
2026-09-21 23:35:59 +00:00
Languages
TypeScript 97.3%
CSS 2.2%
Shell 0.2%
Dockerfile 0.2%