> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anarlog.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix the most common recording, transcription, summary, and calendar problems.

## Audio is missing

Open **Settings → Permissions** and confirm:

* **Microphone** is allowed so Anarlog can hear you.
* **System Audio** is allowed so Anarlog can hear the other people on the call.

If a permission is denied, use **Open** to change it in your operating system's settings, then restart Anarlog.

On Linux, confirm that your desktop audio service can see the microphone and the output-monitor source. On Windows or Linux, include the app and operating-system versions if audio works in other apps but not in Anarlog.

## The transcript is not live

Open **Settings → Transcription** and check the selected model. **Live** models transcribe during the meeting. **After recording** models wait until you stop.

If transcription fails, confirm the provider is configured, the model supports your spoken languages, and a local provider is running.

## No summary appears

A summary needs an Intelligence model. Open **Settings → Intelligence**, then select Anarlog Cloud or configure another provider.

For LM Studio and Ollama, confirm the local server is running. See [Transcription and AI](/ai-setup).

## Calendar events are missing

Open **Calendar** and confirm the account is connected and the calendar is enabled. Refresh the calendar list. Reconnect any account marked **Reconnect required**.

For Apple Calendar, also check **Settings → Permissions → Calendar**.

## A recording disappeared

Open **Settings → Meetings** and check **Audio file retention** under **Audio**. Anarlog can delete audio immediately or after a selected period while keeping the note and transcript.

See [Data, privacy, and retention](/data-and-privacy#choose-how-long-audio-is-kept) for every retention option.

## An imported file does nothing

Audio imports accept WAV, MP3, OGG, MP4, M4A, FLAC, WebM, and AAC. Transcript imports accept SRT and VTT.

For audio, confirm that a Transcription model is selected and that a local provider is running. See [Import audio or a transcript](/import-recordings).

## Meeting-history import shows no apps

Anarlog lists supported meeting assistants it detects on your computer. Open the source app, restart Anarlog, and return to **Settings → Imports**.

If you already removed the source app, reinstall it long enough to complete the import or export the transcript as SRT or VTT and [import it into an empty note](/import-recordings#import-a-transcript).

## Chat has no meeting context

Open the meeting before opening Chat and wait for its transcript or summary to finish. The open meeting is added automatically when its content is available. If Chat still answers without it, start a new chat from that meeting and name the meeting in your request. If no Intelligence model is configured, open **Settings → Intelligence**.

See [Chat with your meetings](/chat) for context guidance and example requests.

## Sharing does not work

Sharing requires Anarlog Pro, a signed-in account, an internet connection, and a generated summary. If a recipient cannot open the note, check their invitation and **General access** under **Share**.

For an **Anyone with the link** share, copy the current link again. Replacing a link invalidates the earlier URL. See [Share meetings](/sharing).

## An automation did not run

Open **Automations**, select the automation, and check whether it is enabled and what its last run reports. Confirm that:

* The destination channel, page, team, or folder is selected.
* Slack, Notion, or Linear is still connected.
* The meeting finished and produced the summary or action items the automation needs.
* A local Markdown folder still exists and is writable.

See [Automate meeting follow-up](/automations).

## Cloud sync is blocked

Open **Settings → Sync** and use the message shown there:

* **Setup required:** Create a recovery key or enter the existing key.
* **Sign in again** or **Identity mismatch:** Sign out and sign back in with the account that owns the synced notes.
* **Device limit reached:** Remove an unused device or use **Get more slots** in **Settings → Sync → Devices** to add slots to a personal Pro subscription. Your plan and add-ons determine the limit.
* **macOS Keychain error:** Click **Repair Keychain Access**, then resume sync.

<Warning>
  Do not move or delete local data while an identity problem is unresolved.
</Warning>

See [Cloud sync](/sync#fix-a-blocked-sync).

## The app does not open after installation

Confirm that you downloaded the build for your operating system and CPU. On Linux, make an AppImage executable before opening it:

```bash theme={null}
chmod +x ./anarlog-*.AppImage
```

For Debian or Ubuntu, install the DEB with `sudo apt install ./anarlog-*.deb` so the package manager can resolve dependencies. See [Install the desktop app](/desktop-installation).

## Linux opens a black window and plays music

First launch opens the setup screen and plays quiet background music. A black window with loud or looping audio usually means WebKitGTK failed to paint, most often on Wayland with NVIDIA.

Current builds disable the WebKit DMA-BUF renderer automatically. If the window is still black, launch with:

```bash theme={null}
WEBKIT_DISABLE_DMABUF_RENDERER=1 WEBKIT_DISABLE_COMPOSITING_MODE=1 ./anarlog-*.AppImage
```

The same variables work for the installed `anarlog` command. See [Install the desktop app](/desktop-installation).

## Get more help

Email [team@fastrepl.com](mailto:team@fastrepl.com), [join Discord](https://anarlog.so/discord), or [open a GitHub issue](https://github.com/fastrepl/anarlog/issues).

Include your operating system, Anarlog version, the exact error, what you expected, and the shortest steps that reproduce the problem. For AI failures, include the selected provider and model.

<Warning>
  Never include API keys, recovery keys, meeting content, or private share links when reporting a problem.
</Warning>

For CLI and MCP errors, use the [error reference](/reference/errors).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.