This documentation is at an early stage. Expect gaps and inaccurate content.
Ctrlk
LogosBuilders hub
For the complete documentation index, see llms.txt. This page is also available as Markdown.
ChatGPT

Install Logos Basecamp

Get Logos Basecamp running on your desktop.

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)

End users

None

Build from source with Nix

Contributors, custom builds, unsupported platforms

Nix with flakes enabled

To enable flakes in nix, add experimental-features = nix-command flakes to /etc/nix/nix.conf.

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 installed with flakes enabled.

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.

Install from a prebuilt release

  1. Go to the latest release page 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:

Build and run Logos Basecamp from source

  1. Clone the repository and enter it:

  2. Build Basecamp with Nix flake:

  3. Run the resulting binary:

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:

Last updated

Was this helpful?