Authentication — Install Instructions
Follow these steps to install the MemberServices AddOn on a new OpenForum site.
Prerequisites
- The SQL AddOn
must be installed and configured with a database alias - The Mailer AddOn must be installed for email notifications
Step 1 — Create the database tables
Run the SQL script on the DB page against your member database.
If upgrading from an existing member table, run only the ALTER TABLE statements to add the new lifecycle columns — do not drop the table.
Step 2 — Configure the site
Add the following keys to your site config object (the one stored via openForum.storeObject("config", ...)):| Key | Description | Example | |
| database | DB alias for the member database | my-site-db | |
| webAddress | Base URL of the site (no trailing slash) | https://mysite.example.com | |
| adminEmail | Email address for admin notifications | admin@mysite.example.com | |
| setPasswordUrl | Path to set-password page (optional, defaults to AddOn page) | /SetPassword |
Step 3 — Register the startup trigger
Open OpenForum > Settings > Startup Triggers and add:Step 4 — Set the magic token
Open Admin Page and ensure authentication.config contains a unique magic token value (not the default "magic").
Step 5 — Register the Admin account
Register the first account (Admin) using the Registration Form.
Step 6 — Run install.sjs
Open this page and run install.sjs. This will:- Copy login.sjs into /OpenForum/Authentication/
- Copy the sign-in popup into /OpenForum/Access/SignIn/
- Copy authentication.config to /OpenForum/Users/Admin/ (if not already present)
Step 7 — Smoke test
- Register a new test member at /OpenForum/AddOn/MemberServices/Register
- Check email for the verification link and follow it
- Set a password on the SetPassword page
- Sign in with the new credentials
- Test password reset via the sign-in page