--- url: /guides/install-the-desktop-app.md description: >- Run Hule as an app on your computer — the Hule Do desktop app for macOS, Windows and Linux, or the web app installed from your browser — and on your phone. --- # Install the desktop app Install Hule as an app when you want: * Hule in its own window; * an icon in the Dock or taskbar; * system [notifications](/guides/set-up-notifications). On a computer, install the [web app from your browser](#web-app-from-your-browser). On a phone, Hule runs in the [browser](#phone-browser) with a mobile layout made for the small screen. ## Desktop app or web app | | Desktop app **Hule Do** | Web app installed from the browser | |---|---|---| | Systems | macOS 11 or later (Apple silicon and Intel), Windows (x64), Linux (x64: AppImage or `.deb`) | any system with a browser that can install [web apps](https://en.wikipedia.org/wiki/Progressive_web_app) | | Notifications | system pop-ups; unread count on the Dock icon (macOS) or the taskbar button (Windows), on Linux only where the launcher supports it; keeps running in the tray | system pop-ups, once you allow them: switch **Desktop pop-ups** off and on in [notification settings](/guides/set-up-notifications#channels-where-notifications-reach-you) | | Updates | downloads updates by itself and asks to restart; a `.deb` install also asks for your admin password | shows "A new version is ready"; click **Reload** to switch to it | | Also | opens task links from [Raycast](/guides/use-raycast), find in page (Cmd/Ctrl+F, see [Keyboard shortcuts](/reference/keyboard-shortcuts)) | nothing to download | ## Web app from your browser 1. Open [app.hule-do.com](https://app.hule-do.com) and sign in. Your workspaces open. 2. Use your browser's own install command, for example the install icon at the right end of the address bar in Chrome or Edge, or **Add to Dock** in Safari on a Mac. A **Hule** icon appears with your apps. ![The Chrome address bar on app.hule-do.com with the install icon at its right end](/shots/guides/install-the-desktop-app-3.webp) ::: info No install button in Hule Hule has no install button of its own; the browser installs it. ::: 3. Open **Hule** from where your system put it. Hule opens in its own window. When a new version is out, the message "A new version is ready" appears; click **Reload**. ## Hule Do desktop app ::: warning No public download of Hule Do yet The **Hule Do** desktop app is not publicly downloadable yet. Until downloads open, use the [web app from your browser](#web-app-from-your-browser). ::: These steps apply once you have the installer: * a `.dmg` for macOS; * a setup `.exe` for Windows; * an AppImage or a `.deb` for Linux. 1. Install it: * **macOS:** open the `.dmg` and drag **Hule Do** to **Applications**; * **Windows:** run the setup file; it installs and opens the app; * **Linux:** install the `.deb` with your package manager, or make the AppImage executable and run it. **Hule Do** is now with your apps. 2. Open **Hule Do**. On the first launch, macOS stops it, and Windows may too: the app is not signed by Apple or Microsoft. 3. Allow the first launch: * **macOS 15 and later, first:** macOS says it can't verify **Hule Do**; click **Done**. * **macOS 15 and later, then:** in **System Settings** → **Privacy & Security**, click **Open Anyway** next to Hule Do and confirm in the dialog. * **macOS 14 and earlier:** in **Applications**, right-click **Hule Do**, choose **Open**, then click **Open** in the dialog. * **Windows:** if you see "Windows protected your PC", click **More info**, then **Run anyway**. **Hule Do** opens on the sign-in screen. 4. Sign in. For Google, Telegram or another [sign-in service](/guides/manage-your-account), the app opens your browser and then returns you to the app. Your [workspaces](/concepts/hule-model) open in the **Hule Do** window. ::: warning Sign-in doesn't come back to the app? The app waits three minutes for the browser. Click the sign-in button in the app again and finish in the browser within three minutes. ::: ::: info Closing the window doesn't quit Hule keeps running in the tray (the menu bar on macOS), so notifications keep arriving. The tray menu has **Open Hule Do** and **Quit**. ::: ## Desktop app updates The app checks for updates after you sign in and every four hours, and downloads them in the background. When the message "… ready — restart to apply" appears, click it to restart. To check by hand: 1. Click your name at the bottom of the sidebar and choose **User settings** (see [Manage your account](/guides/manage-your-account)). **User settings** opens. 2. Open **Updates**. 3. Click **Check for updates**. The line next to the button reads "Up to date." or "Downloading v… in the background…". ::: tip Faster on macOS **Check for updates…** is also in the app menu. ::: ::: warning Linux .deb: the update asks for your password A `.deb` install asks for your admin password to update. If you see "Update not installed", click the update message again and enter your password. ::: ## Phone browser Hule switches to its mobile layout when the window is narrower than 768 pixels. Most tablets are 768 pixels wide or more, so they keep the full layout; an iPad mini held upright gets the mobile one. 1. Open [app.hule-do.com](https://app.hule-do.com) in your phone's browser. Hule switches to its mobile layout. 2. To have it on the home screen, use the browser's **Add to Home Screen**. A **Hule** icon appears on the home screen. ::: warning iPhone and iPad: pop-ups need the home-screen icon Notifications work only in Hule opened from the home screen. The mobile layout has no [notification settings](/guides/set-up-notifications): they need a screen 768 pixels wide or more. ::: The bar at the bottom of the screen switches between: * **Navigation** ([folders, lists and views](/concepts/hule-model); **+** creates one); * **Task** (the **New task** page; see [Create and edit tasks](/guides/create-and-edit-tasks)); * **Account** (who is signed in, **Sign out**). A task opens full screen over the list; its properties, comments and subtasks open in sheets from the bottom of the screen. Some view types and pages open on a big screen only; see [Views on mobile](/reference/views-compared#views-on-mobile). ::: info No store apps There are no Hule apps in the App Store or Google Play. ::: ## One account on three devices Boris uses Hule in three places: * **Hule Do** on his Windows laptop at work; * the web app installed from Chrome on his Mac at home; * Hule from the home screen of his iPhone. He signs in to each with the same account and sees the same workspaces. Notification settings are shared too, because they belong to his membership in each workspace, not to the device (see [Set up notifications](/guides/set-up-notifications)). He still allows pop-ups once on each device. ## If it doesn't work * **macOS or Windows blocks the first launch.** The app is not signed by Apple or Microsoft; allow it as in step 3 of [Hule Do desktop app](#hule-do-desktop-app). * **"Update not installed".** On Linux with a `.deb`, click the update message again and enter your password. * **Sign-in doesn't come back to the app.** The app waits three minutes for the browser. Click the sign-in button in the app again and finish in the browser within three minutes. * **The screen says "No internet connection".** Hule needs a connection; it reconnects by itself when the network is back, or click **Try again**. * **"This build has to be updated manually" on Linux.** This copy can't update itself: it is not an AppImage, or it is a `.deb` on a system without `pkexec` or `apt-get`. Install the new version the way you installed this one. * **No pop-ups on an iPad or iPhone.** Add Hule to the home screen and open it from there. In [notification settings](/guides/set-up-notifications#channels-where-notifications-reach-you), switch **Desktop pop-ups** off and on, then tap **Allow**. An iPhone reaches these settings only in landscape; one with a Home button is too narrow even then. ## Related * [Manage your account](/guides/manage-your-account) — sign-in methods, theme and language. * [Use Hule from Raycast](/guides/use-raycast) — add and find tasks on a Mac without opening the app. * [Set up notifications](/guides/set-up-notifications) — pop-ups and other channels. * [Keyboard shortcuts](/reference/keyboard-shortcuts) — shortcuts in the app.