Skip to content

Install the Logos Basecamp app#262

Open
cheny0 wants to merge 2 commits into
mainfrom
251-install-the-logos-basecamp-app
Open

Install the Logos Basecamp app#262
cheny0 wants to merge 2 commits into
mainfrom
251-install-the-logos-basecamp-app

Conversation

@cheny0
Copy link
Copy Markdown
Contributor

@cheny0 cheny0 commented May 14, 2026

The journey "Build and run Logos App (alpha) to access Testnet v0.1 UIs" is split into two documents. The other pr is: #258

@cheny0 cheny0 self-assigned this May 14, 2026
@cheny0 cheny0 added area:core Docs related to Logos Core journeys. quality:stub Placeholder page. Title, status, and known gaps only. Not runnable. type:journey A user journey document (the primary deliverable). release:testnet-v0.1 Items for Testnet v0.1 release. status:doc-ready-for-review labels May 14, 2026
@cheny0 cheny0 linked an issue May 14, 2026 that may be closed by this pull request
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 x86_64 or aarch64 (recent versions).
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't see a macOS x86_64 dmg on the release page. Should macOS x86_64 be listed as a supported OS?

1. Run the resulting binary:

```bash
./result/bin/logos-basecamp
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is correct build output

Suggested change
./result/bin/logos-basecamp
./result/bin/LogosBasecamp

| 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 |
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would add somewhere that /etc/nix/config needs to be changed to have experimental-features = nix-command flakes as this is not trivial to understand from this text and hard to find for anyone not familiar with nix(many people)

## 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
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I actually got into problems with AppImage on Ubuntu 24.04 with No suitable fusermount binary found and then libEGL.so.1 / libOpenGL.so.0 missing

what helped was to install sudo apt-get install -y fuse libegl1 libopengl0

so I am not sure of this claim (cc @iurimatias )

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:core Docs related to Logos Core journeys. quality:stub Placeholder page. Title, status, and known gaps only. Not runnable. release:testnet-v0.1 Items for Testnet v0.1 release. status:doc-ready-for-review type:journey A user journey document (the primary deliverable).

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Install the Logos Basecamp app

2 participants