Installation

Atlas is a native desktop app for Windows, macOS, and Linux. Installation takes just a few minutes.

System Requirements

Before downloading, make sure your computer meets these requirements:

Platform	Minimum Version
Windows	Windows 10 (64-bit) or later
macOS	macOS 12 Monterey or later
Linux	Ubuntu 20.04+, Debian 11+, or any distro supporting AppImage

Atlas requires approximately 150 MB of disk space for the app itself. Your vault folder can be as large as you need — it’s just plain files on your drive.

Download Atlas

Download the latest version from either of these sources:

• Official website: atlasnotes.io/download
• GitHub Releases: github.com/boringbots/atlas-releases

Choose the installer for your operating system from the releases page.

---

Installing on Windows

1. Download the .exe installer file.

2. Double-click the downloaded file to run it.

3. If Windows SmartScreen shows a warning (“Windows protected your PC”), click More info and then Run anyway. This warning appears because Atlas is an indie app — it’s safe to proceed.

4. Follow the on-screen installer steps. Atlas installs to your user folder by default (no admin rights needed).

5. Launch Atlas from the Start menu or the desktop shortcut.

Tip

If your organization’s IT policy blocks .exe installers from unknown publishers, ask your IT team to whitelist Atlas or check whether a pre-approved distribution channel is available.

---

Installing on macOS

1. Download the .dmg disk image file.

2. Double-click the .dmg to mount it, then drag the Atlas icon into your Applications folder.

3. The first time you open Atlas, macOS Gatekeeper will block it because it wasn’t downloaded from the App Store.

   To open it anyway: find Atlas in your Applications folder, right-click (or Control-click) the app icon, and select Open from the menu. Click Open in the dialog that appears.

4. After this first-time approval, Atlas will open normally on every subsequent launch.

Caution

Do not try to open Atlas by double-clicking it the first time — Gatekeeper will only give you the option to move it to trash. You must use right-click > Open to get the option to approve it.

---

Installing on Linux

AppImage (recommended, works on most distros)

1. Download the .AppImage file.

2. Make it executable. Open a terminal and run:

   chmod +x Atlas_*.AppImage

3. Run it:

   ./Atlas_*.AppImage

You can move the AppImage anywhere on your system — your home folder, /opt, or wherever you prefer. No installation needed.

Debian/Ubuntu (.deb package)

1. Download the .deb file.

2. Install it with dpkg:

   sudo dpkg -i atlas_*.deb

3. Launch Atlas from your application menu or run atlas in a terminal.

Note

Atlas on Linux uses WebKit2GTK for its interface. If the app fails to launch, make sure libwebkit2gtk-4.1 is installed on your system.

---

First Launch

When Atlas starts for the first time, it will ask you to choose a vault folder. This is where all your notes and data will be stored.

• Create a new folder if you’re starting fresh (e.g., ~/My Atlas Vault)
• Choose an existing folder if you already have markdown notes you want to use

Atlas will set up its own atlas/ subfolder inside whatever folder you choose. Your existing files won’t be touched.

See Your First Vault for details on what Atlas creates and how your vault is organized.

---

Keeping Atlas Up to Date

Atlas checks for updates automatically. When a new version is available, you’ll see a notification in the app. Click it to download and install the update — the process takes about a minute and restarts the app.

Tip

You can also check for updates manually in Settings > About > Check for Updates.