> For the complete documentation index, see [llms.txt](https://guides.getalby.com/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.getalby.com/user-guide/alby-hub/alby-hub-flavors/desktop.md).

# Desktop

You can run Alby Hub on your own computer, whether it is running on Windows, MacOS, or Linux.

{% hint style="info" %}
Alby Hub for desktop is well-suited for self-hosting for users who have a basic understanding of software configuration and network settings, and have their computers online 24/7 in order to send or receive payments. Therefore, consider this option if you keep the desktop computer **always online**.

Otherwise, we recommend running Alby Hub on an always-online device — such as a server, a node device like Umbrel or Start9, or a cloud provider — to ensure your wallet is always online. 👍
{% endhint %}

## Installing Alby Hub on Desktop

### Windows **💻**

{% embed url="<https://demos.getalby.com/demo/clyxrnjdh00uwh5yz026de5x6>" %}

### macOS **🍏**

{% embed url="<https://demos.getalby.com/demo/cm6b1rq9p0pkk280i2407f09m>" %}

### Linux **🐧**

{% embed url="<https://demos.getalby.com/demo/clz0o1u7p0074dr84mv73tvxg>" %}

<details>

<summary><strong>Installing on Linux for advanced users</strong></summary>

Click [here](https://github.com/getAlby/hub?tab=readme-ov-file#custom-ubuntu-vm) to get started.

</details>

<details>

<summary><strong>Linux Troubleshooting:</strong> Common Errors</summary>

* **Ubuntu 22.04 Crash on Startup**: If AlbyHub crashes on startup, try running `sudo apt-get install libwebkit2gtk-4.0-37`. This resolves a known issue with missing dependencies.
* **Blank White Screen with Graphics Acceleration**: If after installing the necessary libraries, AlbyHub still shows a blank white screen, launch the app with the command `export WEBKIT_DISABLE_DMABUF_RENDERER=1` to disable the problematic renderer.
* **Server Version Recommendation**: For users experiencing persistent issues, we recommend using the server version of AlbyHub. It lacks a GUI, making it less prone to graphical errors.

</details>

***

## Download Alby Hub

### Select your operating system below

The download of Alby Hub app files starts automatically.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="image">Cover image</th></tr></thead><tbody><tr><td><strong>Alby Hub for Windows</strong></td><td><code>.zip</code> file</td><td><strong>Download</strong></td><td><a href="https://getalby.com/install/hub/windows">https://getalby.com/install/hub/windows</a></td><td><a href="https://2706948649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIUBf3ZZaBGu2ee6Y8lU%2Fuploads%2FRoGsGVAEa6Zbm4kdPmWu%2FGroup%2013.png?alt=media&amp;token=2cd2e953-4332-4571-b147-bb85e08738fc">Group 13.png</a></td></tr><tr><td><strong>Alby Hub for MacOS</strong></td><td><code>.dmg</code> file</td><td><strong>Download</strong></td><td><a href="https://getalby.com/install/hub/macos">https://getalby.com/install/hub/macos</a></td><td><a href="https://2706948649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIUBf3ZZaBGu2ee6Y8lU%2Fuploads%2FHLDr4W1KquuOf1gdWHpH%2FGroup%2014.png?alt=media&amp;token=6bcd7253-9295-414b-8ddf-5a7f87e5f521">Group 14.png</a></td></tr><tr><td><strong>Alby Hub for Linux</strong></td><td><code>.tar.bz2</code> file</td><td><strong>Download</strong></td><td><a href="https://getalby.com/install/hub/desktop-linux">https://getalby.com/install/hub/desktop-linux</a></td><td><a href="https://2706948649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWIUBf3ZZaBGu2ee6Y8lU%2Fuploads%2FAd7xoQrXn1GGx3Oou8LE%2FGroup%2012.png?alt=media&amp;token=37363c0c-9e65-433b-a15c-f1c3fc0f5d85">Group 12.png</a></td></tr></tbody></table>

### Extract the zip file

This may vary slightly between systems.

### Install Alby Hub

Open the file manually or add it to the system startup if you want it to run permanently each time you restart your computer.

{% hint style="success" %}
**Congrats! Your Alby hub is now running on your desktop 🎉**\
Remember, keeping your Alby Hub online is crucial to send and receive payments at any point in time.
{% endhint %}

***

## Uninstalling and deleting everything

{% hint style="danger" %}
Warning: This may result in a loss of funds. Make sure your Hub is empty before following these instructions to completely remove it.
{% endhint %}

To completely remove Alby Hub from a Windows desktop, first close the app, then uninstall it from Settings under Apps if it appears there. After that, delete its data folder located at `C:\Users\AppData\Local\albyhub`.

On a Mac, close the app, drag Alby Hub from the Applications folder to the Trash, and then delete its data folder, which may be found at `~/Library/albyhub` or, in some cases, at `~/Library/Containers/com.getalby.Alby-Hub/Data/Library/Application Support/albyhub`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://guides.getalby.com/user-guide/alby-hub/alby-hub-flavors/desktop.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.