> For the complete documentation index, see [llms.txt](https://docs.logos.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.logos.co/run-an-app/get-started/install-logos-basecamp.md).

# Install Logos Basecamp

#### Get Logos Basecamp running on your desktop.

{% hint style="info" %}

* **Permissions**: No special permissions required.
* **Product**: Logos Basecamp.
  {% endhint %}

Logos Basecamp is the desktop shell for Logos. You can discover, install, and run Logos modules and apps using its graphical interface as an alternative to the command line.

You can install Logos Basecamp in two ways:

| Method                                                                  | When to use it                                     | Tooling required        |
| ----------------------------------------------------------------------- | -------------------------------------------------- | ----------------------- |
| [Prebuilt release (AppImage or DMG)](#install-from-a-prebuilt-release)  | End users                                          | None                    |
| [Build from source with Nix](#build-and-run-logos-basecamp-from-source) | Contributors, custom builds, unsupported platforms | Nix with flakes enabled |

{% hint style="info" %}
To enable flakes in nix, add `experimental-features = nix-command flakes` to `/etc/nix/nix.conf`.
{% endhint %}

Before you start, make sure you have the following:

* Internet access.
* A supported OS: Linux x86\_64 or aarch64 (tested on Ubuntu 22.04+), or macOS aarch64 (recent versions).
* 4 GB RAM minimum (8 GB recommended) and \~2 GB free disk space.
* For the source build only: [Nix](https://github.com/NixOS/nix-installer) installed with flakes enabled.

{% hint style="info" %}
Internet access is required to download the binary or clone the repository, but not to launch Logos Basecamp afterward. Logos Basecamp itself opens no inbound ports.
{% endhint %}

## Install from a prebuilt release

1. Go to the [latest release page](https://github.com/logos-co/logos-basecamp/releases/latest) and download the artifact for your OS:
   * Linux: the `AppImage` files
   * macOS: the `.dmg` files
2. Depending on your OS, install and launch Basecamp as follows:

* On macOS, drag the `.dmg` file into `/Applications`. Then launch Basecamp from `/Applications`.
* On Linux, grant execute permission to the downloaded AppImage and launch it:

  ```bash
  chmod +x LogosBasecamp-Desktop-*.AppImage
  ./LogosBasecamp-Desktop-x86_64.AppImage  # or logos-basecamp-aarch64.AppImage
  ```

## Build and run Logos Basecamp from source

1. Clone the repository and enter it:

   ```bash
   git clone https://github.com/logos-co/logos-basecamp.git
   cd logos-basecamp
   ```
2. Build Basecamp with Nix flake:

   ```bash
   nix build '.#app'
   ```
3. Run the resulting binary:

   ```bash
   ./result/bin/LogosBasecamp
   ```

## Troubleshooting Basecamp

### I see an `libEGL.so.1 / libOpenGL.so.0 missing` error when trying to launch the AppImage on Linux?

Try running the following command:

```bash
sudo apt-get install -y fuse libegl1 libopengl0
```


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.logos.co/run-an-app/get-started/install-logos-basecamp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.