diff --git a/.changeset/red-chefs-beam.md b/.changeset/red-chefs-beam.md
new file mode 100644
index 0000000000..5cadccb0aa
--- /dev/null
+++ b/.changeset/red-chefs-beam.md
@@ -0,0 +1,6 @@
+---
+'@backstage/plugin-airbrake': patch
+'@backstage/plugin-airbrake-backend': patch
+---
+
+The Airbrake plugin installation instructions have been updated to work better and conform to how the frontend and backend plugins are supposed to be integrated into a Backstage instance.
diff --git a/plugins/airbrake-backend/README.md b/plugins/airbrake-backend/README.md
index 9c9b56ade4..21056229de 100644
--- a/plugins/airbrake-backend/README.md
+++ b/plugins/airbrake-backend/README.md
@@ -24,7 +24,7 @@ This method of serving the plugin provides quicker iteration speed and a faster
 
 3. Go into the plugin's directory and run it in standalone mode by running `yarn start`.
 
-Access it from http://localhost:7007/api/airbrake. Or use the Airbrake plugin which will talk to it automatically.
+Access it from http://localhost:7007/api/airbrake. Or use the [Airbrake plugin in standalone mode](../airbrake/README.md#local-development) which will talk to it automatically.
 
 Here are some example endpoints:
 
diff --git a/plugins/airbrake/README.md b/plugins/airbrake/README.md
index d5ea9bb006..bc830c326d 100644
--- a/plugins/airbrake/README.md
+++ b/plugins/airbrake/README.md
@@ -20,7 +20,7 @@ The Airbrake plugin provides connectivity between Backstage and Airbrake (https:
    yarn add @backstage/plugin-airbrake-backend
    ```
 
-3. Add the `EntityAirbrakeContent` to `packages/app/src/components/catalog/EntityPage.tsx`:
+3. Add the `EntityAirbrakeContent` to `packages/app/src/components/catalog/EntityPage.tsx` for all the entity pages you want Airbrake to be in:
 
    ```typescript jsx
    import { EntityAirbrakeContent } from '@backstage/plugin-airbrake';
@@ -32,40 +32,78 @@ The Airbrake plugin provides connectivity between Backstage and Airbrake (https:
        </EntityLayout.Route>
      </EntityLayoutWrapper>
    );
+
+   const websiteEntityPage = (
+     <EntityLayoutWrapper>
+       <EntityLayout.Route path="/airbrake" title="Airbrake">
+         <EntityAirbrakeContent />
+       </EntityLayout.Route>
+     </EntityLayoutWrapper>
+   );
+
+   const defaultEntityPage = (
+     <EntityLayoutWrapper>
+       <EntityLayout.Route path="/airbrake" title="Airbrake">
+         <EntityAirbrakeContent />
+       </EntityLayout.Route>
+     </EntityLayoutWrapper>
+   );
    ```
 
-4. Setup the Backend code in `packages/backend/src/index.ts`:
+4. Create `packages/backend/src/plugins/airbrake.ts` with these contents:
 
    ```typescript
+   import { Router } from 'express';
+   import { PluginEnvironment } from '../types';
    import {
-     createRouter as createAirbrakeRouter,
+     createRouter,
      extractAirbrakeConfig,
    } from '@backstage/plugin-airbrake-backend';
 
-   async function main() {
-     //... After const config = await loadBackendConfig({ ...
-
-     const airbrakeRouter = await createAirbrakeRouter({
+   export default async function createPlugin({
+     logger,
+     config,
+   }: PluginEnvironment): Promise<Router> {
+     return createRouter({
        logger,
        airbrakeConfig: extractAirbrakeConfig(config),
      });
-
-     const service = createServiceBuilder(module)
-       // ... Add the airbrakeRouter here
-       .addRouter('/api/airbrake', airbrakeRouter);
    }
    ```
 
-5. Add this config as a top level section in your `app-config.yaml`:
+5. Setup the Backend code in `packages/backend/src/index.ts`:
+
+   ```typescript
+   import airbrake from './plugins/airbrake';
+
+   async function main() {
+     //... After const createEnv = makeCreateEnv(config) ...
+
+     const airbrakeEnv = useHotMemoize(module, () => createEnv('airbrake'));
+
+     //... After const apiRouter = Router() ...
+     apiRouter.use('/airbrake', await airbrake(airbrakeEnv));
+   }
+   ```
+
+6. Add this config as a top level section in your `app-config.yaml`:
 
    ```yaml
    airbrake:
      apiKey: ${AIRBRAKE_API_KEY}
    ```
 
-6. Set an environment variable `AIRBRAKE_API_KEY` with your [API key](https://airbrake.io/docs/api/#authentication)
+7. Set an environment variable `AIRBRAKE_API_KEY` with your [API key](https://airbrake.io/docs/api/#authentication)
    before starting Backstage backend.
 
+8. Add the following annotation to the `catalog-info.yaml` for a repo you want to link to an Airbrake project:
+
+   ```yaml
+   metadata:
+     annotations:
+       airbrake.io/project-id: '123456'
+   ```
+
 ## Local Development
 
 Start this plugin in standalone mode by running `yarn start` inside the plugin directory. This method of serving the plugin provides quicker