Skip to content

Basalt v1.5.0

Choose a tag to compare

@Dushmantha-Amarasinghe Dushmantha-Amarasinghe released this 10 Oct 20:38
· 279 commits to main since this release

Basalt v1.5.0

Basalt Host now runs on Linux too: on a desktop, or with no screen at all on a home server, a NAS or a Raspberry Pi, set up and managed entirely from the Basalt app. A device can now manage its host from anywhere in the house, every device signs in with a security key of its own, and hosts keep themselves up to date.

What's new

Basalt Host for Linux

  • On a Linux desktop. The same Basalt Host as on Windows, with the same window, for Ubuntu 22.04 and later, Debian 12, Linux Mint 21 and later, Fedora, or any desktop with the AppImage.
  • With no screen. For a home server, a NAS or a Raspberry Pi, Basalt Host runs as a background service that starts with the computer. Packages for 64-bit PCs and ARM boards install on Debian 11 and later, Ubuntu 20.04 and later, Raspberry Pi OS, Fedora and Rocky Linux.
  • Set up from your phone. A host with no screen shows a one-time setup code when it is installed. Choose the host marked new in Basalt, type the code, and that device manages the host from then on. Setting up only ever happens on your own network.
  • In Docker. For a NAS or a home server, Basalt Host is also a Docker image for 64-bit PCs and ARM boards: ghcr.io/refora-technologies/basalt-host. It is signed, and records the GitHub workflow that built it.
  • Plain answers at the computer. sudo basalt-host status shows whether the host is running, its address, what it shares, its devices and the setup code. start, stop, restart and update say what they did.
  • The Basalt app for Linux is next. Until it arrives, open a Linux host's drive from Basalt on Windows or Android.

Manage your host from any device

  • Everything the host's window does. Let a device manage the host, and Manage host on that phone or computer can choose or rename the shared drive, let new devices in, make a device read only, add and remove profiles, and change the library, conversion and section settings. Changes reach every device at once.
  • Browse to share a folder. Choose Choose a folder… and tap through the host's folders, instead of typing a path.
  • Rename the drive. The shared drive can be renamed, from Manage host or from Basalt Host itself, without sharing it again.

Hosts keep themselves up to date

  • Updates go in by themselves. Basalt Host looks for a new version twice a day and installs it when nothing is playing or copying. It restarts by itself, and your devices reconnect. Turn off Update automatically in Basalt Host's settings, or under Updates in Manage host, to install updates yourself.
  • Update now, from anywhere. A device that manages the host can see its version and update it with one press.
  • Starts with your computer. A host set up with 1.5 starts when the computer does, so your devices find it whenever they look. A host set up before keeps its setting: turn on Start when Windows starts (on Linux, Start when you log in) in its settings.
  • Always the official release. Every update is the newest release published here, checked against its published checksum before it is installed. A device can ask for an update, but never choose what is installed.

A security key for every device

  • Signed in with its own key. Each device now signs in with a key created on the device and kept in its security chip when it has one. The key never leaves the device, so a copy of its settings can no longer open your drive.
  • Moves over by itself. Paired devices move to their key the next time they connect, once the host is updated. Devices still on an earlier version keep working, and Basalt Host lists which ones still need updating.

Profiles from your other drives

  • Bring your profile. A profile from one drive can be used on another host. Someone who manages that host lets it in once, and from then on it signs in there with no PIN of its own, while its PIN stays on its own drive.

Clearer everywhere

  • Plain words. Every screen, message and setting in Basalt and Basalt Host was rewritten to say what it means in everyday words.
  • When the host is not running, Basalt now says so plainly, rather than showing a system error.
  • Windows Firewall. If Windows Firewall blocks Basalt Host on your network, the host's window now says so.

Fixes

  • On Android, the keyboard covered fields near the bottom of the screen, such as when adding a profile or renaming.
  • After pairing with a second host, the app still showed the profile signed in on the first.
  • A host's drive name stayed as it was when the device first paired, even after it was renamed.
  • When a device was allowed to manage the host, it only noticed after signing out and in again.
  • A drive chosen from the list in Manage host was named after its whole path rather than its folder.
  • On a computer with several network adapters, the host listed a virtual adapter's address first.

Installation

File Install on
Basalt-Host-Setup.exe A Windows computer with the drive
Basalt-Host-Linux-amd64.deb, Basalt-Host-Linux-x86_64.rpm, Basalt-Host-Linux-x86_64.AppImage A Linux desktop with the drive
Basalt-Host-Server-Linux-amd64.deb, -arm64.deb, -x86_64.rpm, -aarch64.rpm, .tar.gz A Linux computer with no screen
ghcr.io/refora-technologies/basalt-host:1.5.0 Docker, on a NAS or a home server
Basalt-Client-Setup.exe Every Windows computer that connects to it
Basalt-Android.apk Android phones and tablets

Updating

Update the computer with the drive first, then your other devices. Basalt 1.4.6 offers this update by itself, at the top of Basalt Host, in the Windows sidebar, and on Android. Devices still on 1.4.6 keep working with a 1.5 host. Once a device is on 1.5, going back to an earlier version on it means pairing it again.

Windows

The Windows installers update an existing installation in place and keep your pairing and settings. They install per user and do not need administrator rights.

Linux

On a Linux desktop:

sudo apt install ./Basalt-Host-Linux-amd64.deb      # Ubuntu, Debian, Linux Mint
sudo dnf install ./Basalt-Host-Linux-x86_64.rpm     # Fedora

Or make the AppImage executable and open it.

On a computer with no screen, install the package for its processor (amd64/x86_64 for a PC, arm64/aarch64 for a Raspberry Pi or other ARM board), for example sudo apt install ./Basalt-Host-Server-Linux-arm64.deb. When it finishes, it shows the host's address, its setup code and anything left to do; sudo basalt-host status shows them again. The full guide is in packaging/linux/README.md.

Docker

With Docker Compose:

services:
  basalt:
    image: ghcr.io/refora-technologies/basalt-host:latest
    container_name: basalt
    network_mode: host
    environment:
      - PUID=1000
      - PGID=1000
    volumes:
      - ./config:/config
      - /srv/media:/media/Media
    restart: unless-stopped

Change /srv/media to the folder with your files, then run docker compose up -d. docker exec basalt basalt-host status shows the setup code. The image is for amd64 and arm64, and a container updates when you pull the new image: docker compose pull && docker compose up -d. Settings, NAS setup and checking the image's signature are in docker/README.md.

Android

The Android app needs Android 8.0 or later on a 64-bit phone or tablet. It is not on the Play Store yet: open the .apk on the phone, and allow your browser or file manager to install it when Android asks. That permission is only for installing and can be switched off again afterwards.

Checksums

A .sha256 checksum is published beside each file, and SHA256SUMS lists them all.

Windows 10 / 11 · Linux · Docker · Android 8.0+ · GPLv3 · © 2026 Refora Technologies