User Onboarding & Church Join Codes

Welcome to Koinonia OS! Whether you are a parishioner joining your local church digital community for the first time or a church administrator setting up a new parish account, this guide covers everything you need to get started.

Tip: You can join your church in under 60 seconds if you already have your parish's unique 8-character Join Code from your church admin or servant.

1. Joining an Existing Church

If your church is already using Koinonia OS, follow these steps to connect your user account:

  1. Navigate to the Koinonia OS portal at https://koinoniaos.com.

  2. Click Sign Up and create an account using your email address or Google OAuth.

  3. On the welcome screen, select the Join an Existing Parish tab.

  4. Enter your parish's 8-character Join Code (for example: STMARY01).

  5. Fill in your basic profile details (Full Name, Phone Number, and Address).

  6. Click Submit Join Request.

Important: After submitting your join request, your status will be Pending Approval until a parish administrator or priest approves your request. You will receive an email notification as soon as your account is activated.

---

2. Registering a New Parish

If you are a priest or church leader registering a new church organization on Koinonia OS:

  1. Click Create a New Parish on the registration screen.

  2. Enter your Official Church Name, Diocese affiliation, Timezone, and Contact Email.

  3. Choose your initial subscription tier (Free, Basic, Pro, or Enterprise).

  4. Click Establish Parish. Koinonia OS will automatically provision your workspace and generate your parish's unique 8-character Join Code.

  5. Share this Join Code with your church board, servants, and parishioners.

---

3. How Admins Find & Regenerate Join Codes

Parish administrators can locate or rotate the Join Code at any time:

  1. Log in as an Administrator.

  2. Navigate to Settings > Organization & Branding.

  3. Locate the Parish Join Code field.

  4. Click Copy Code to share via bulletin, email, or SMS.

  5. If a code needs to be revoked for security, click Regenerate Code to generate a fresh 8-character key immediately.

Warning: Regenerating your Join Code invalidates the previous code immediately. Any unsubmitted join requests using the old code will need to use the new code.