Installation Guide

Install Republic across your organisation

Republic is published in the Microsoft Teams store and ships with a companion Outlook add-in. Pick your platform below, or take the whole thing away as a PDF.

Download the PDF guideAlready installed via manifest?
Free to add and use~10 minutes to deployMicrosoft 365 admin rights required
Installation guidePDFThe whole of this page as an 8-page PDF — Teams, Outlook, manifest downloads and troubleshooting.Download
Teams store upgrade guidePDFFor organisations already running Republic from an uploaded manifest who want to move to the store version.Download

Republic by Recyber

Recyber

Works in
Teams, Outlook & Microsoft 365
Cost
Free to add and use
Store
Microsoft Teams app store

Before you begin

  • A Teams Administrator or Global Administrator account for your Microsoft 365 tenant.
  • Your Republic tenant provisioned by Recyber — your onboarding contact confirms this before rollout.
  • A decision on scope: the whole organisation, or a pilot group first.
For administrators

Deploy Republic to your organisation

This is the recommended route. It installs Republic for everyone in scope so your people don't have to find or add anything themselves.

1

Open the Teams admin centre

Sign in at admin.teams.microsoft.com with an account that holds the Teams Administrator or Global Administrator role.

admin.teams.microsoft.com
2

Find Republic in Manage apps

Go to Teams apps → Manage apps and search for "Republic by Recyber". Open the app to review its details and the permissions it requests.

3

Allow the app

If your organisation blocks third-party apps by default, set the app's status to Allowed. Where a permission policy is assigned to your users, make sure that policy also permits Republic.

4

Add Republic to a setup policy

Go to Teams apps → Setup policies and open the policy your users are assigned to — usually Global (Org-wide default). Under Installed apps select Add apps, choose Republic by Recyber, and add it. Add it under Pinned apps too so it appears in the Teams sidebar rather than behind the ellipsis.

5

Scope and save

Save the policy. For a pilot, create a separate setup policy and assign it to a group instead of editing the org-wide default. Microsoft can take up to 24 hours to push policy changes to every client, so schedule your launch comms accordingly.

6

Grant consent and confirm

The first time a user opens Republic they sign in with their work account. If your tenant requires admin consent for new applications, approve the request in Microsoft Entra ID → Enterprise applications so users aren't blocked at first launch.

Alternative

Deploy from the manifest instead

Only needed where your organisation deploys Teams apps as custom packages rather than from the store. A custom upload stays on the version you uploaded — the store version updates itself, so prefer that route where your policies allow it.

1

Download the app package

Download republic-teams-app.zip (Teams app v2.1.0). Upload the zip exactly as downloaded — do not unzip it first.

Download republic-teams-app.zip
2

Upload it as a custom app

In the Teams admin centre go to Teams apps → Manage apps, select Actions → Upload new app, and choose the zip.

3

Wait for it to appear

Depending on the size of your organisation the app can take up to an hour to show in the list.

4

Allow it and add it to a setup policy

Set the app's status to Allowed, then add it to the relevant setup policy under Installed apps and Pinned apps, exactly as with the store route.

Alternative

Let people install it themselves

If your organisation already allows users to add apps from the Teams store, no admin action is needed — staff can add Republic in under a minute.

1

Open the app store in Teams

In Microsoft Teams, select Apps in the left sidebar.

2

Search for Republic

Type "Republic" and select Republic by Recyber from the results.

3

Add the app

Select Add. Republic is free to add and use — there is no in-product purchase step.

4

Pin it

Right-click the Republic icon in the sidebar and choose Pin so it stays visible between sessions.

What your people will see

  • A welcome message from Republic in Teams introducing what the app does and how long it takes.
  • Around four short assessment questions a week, delivered in chat — under three minutes of effort in total.
  • After the first six weeks, personalised micro-learning based on the behaviours their answers surfaced.
  • Administrators get organisation-level reporting and user risk tracking in the Republic dashboard.

Troubleshooting

Republic doesn't appear in Manage apps

Newly published store apps can take up to an hour to surface in a tenant's app catalogue. Clear the search filters, confirm you are searching the Microsoft apps catalogue rather than Custom apps, and try again shortly.

Users can't see the app after a policy change

App setup policy assignments can take up to 24 hours to reach every client. Ask an affected user to sign out of Teams and back in, and confirm they are assigned the policy you edited.

Users are blocked at sign-in

This usually means your tenant requires admin consent for new applications. A Global Administrator can approve Republic in Microsoft Entra ID → Enterprise applications.

Rollout

Telling your people.

Deployment is only half of it. Republic lands best when people know it is coming, so here is the announcement to send — copy it as it is, or make it sound like you.

Send it once the rollout has propagated

Setup policies can take up to 24 hours to reach every Teams client and a centrally deployed add-in up to six hours to reach every mailbox. Announce Republic after that window, not before — a message about an app people cannot yet see creates support tickets rather than momentum.

SubjectIntroducing Republic — your new security coach

Our organisation has partnered with Recyber to bring you Republic, a new behavioural security solution designed to help reduce human cyber risk. Accessible through Microsoft Teams and your browser, Republic acts as your personal security coach, offering support only when you need it and making security a positive, rewarding experience. By combining the latest behavioural science with storytelling and gamification, we help you build strong security habits naturally. This isn't just another training tool; it's security reimagined.

Republic also includes a phishing game called Interception. It helps you practise secure email reporting while unlocking levels with increasingly deceptive emails. Emails are delivered at a consistent pace across all levels, but you'll earn more Virtucoin for completing the harder ones. Interception is played directly from your email inbox using the Recyber add-in for Outlook — the Report Phishing button on your message ribbon — and your progress is managed through the Map section of the main Republic app in your browser, where you can view and select from available levels at any time.

You'll soon get a message from the Republic Teams bot, which will give you a quick tour and get you up and running.

If you require help or assistance you can access the Recyber Support Hub at https://recyber.atlassian.net/servicedesk.

Two things worth adding

Say who to contact internally. People who hit a problem should know whether to raise it with IT or go straight to the Recyber Support Hub.

Say plainly that Republic is not a monitoring tool. It coaches individuals and reports risk to the organisation in aggregate — stating that up front prevents the question being asked in the wrong tone later.

Files you need

Manifests and guides.

Served over HTTPS and always the current version. Download them on the machine you're running the admin centre from.

ZIPTeams app packageOnly for custom-app deploymentVersion 2.1.0. Contains the manifest and app icons. Upload the zip as-is — do not unzip it.republic-teams-app.zipDownload
XMLOutlook add-in manifestRequired to deploy the add-inOne file for classic Outlook on Windows, new Outlook, Outlook on the web and Outlook on Mac.republic-outlook-report-phishing.xmlDownload

Identifiers

Teams app ID1f518d36-07de-4ce5-860c-cc774c7bf327
Outlook add-in IDee7dee35-d48b-4221-904c-115af0017096

These are how you identify Republic in the admin centre — and how you tell the store version apart from a manually uploaded one.

Installation guide (PDF)Store upgrade guide (PDF)

Need a hand with rollout?

Our onboarding team can walk your administrators through deployment and provide staff communication templates.

Contact UsGetting Started Guide