Skip to content

Blank Box Community - Hotfix - Docker user and storage settings

Pre-release
Pre-release

Choose a tag to compare

View all tags
@blankboxcode blankboxcode released this 30 Sep 22:23
· 16 commits to main since this release
Immutable release. Only release title and notes can be modified.
v0.1.0-beta.9
4683c85

We’ve fixed the Docker permissions so you can run Blank Box with your own Linux UID/GID, including 1000:1000. Our default remains 10001:10001.

You can also store your library in a dedicated host folder using a bind mount. Our Docker guide now includes a complete example for both settings.

Downloads

  • Linux / Docker installation ZIP — includes the prebuilt application, setup tools, guides and four optional signed starter metapacks. No Node.js or npm is needed to install it.
  • Source ZIP — for reviewing or building the source.
  • Windows x64 ZIP — our existing Windows download remains available and experimental.

New Docker installation

You’ll need a Linux host with Docker Engine and the Compose plugin.

Verify and extract the installation ZIP, then open a terminal in the folder containing compose.yaml. For the default setup, run:

cp -n blankbox.env.example .env
docker compose up --detach --build --wait --wait-timeout 240

Read your recovery key privately:

docker compose exec -T blankbox python3 -c 'print(open("/data/access-key.txt").read().strip())'

Open http://127.0.0.1:25265 on the Docker host and use the key to create your local account.

To use your own UID/GID and a host data folder, follow the optional setup example before starting the container for the first time. Keep those settings in compose.override.yaml, beside compose.yaml.

Update an existing Docker installation

  1. Verify the new installation ZIP and extract it into a new folder.
  2. Copy your existing .env and any Compose override files into that folder.
  3. Keep your current user, project name and data mount, then run:
./upgrade-docker.sh

Sign in and check your library afterward. Keep the previous image and recovery snapshot retained by the update tool.

Changing user or storage is a separate step. Update with your current settings first. Before switching from a Docker volume to a bind folder, stop Blank Box and copy the complete /data contents. The new folder and its contents must belong to your selected user.

Keep the original volume until the new setup is checked. Changing a mount does not move data.

Native Linux installation

Use the same installation ZIP and run:

sudo ./setup-linux.sh

You’ll need Python 3.10+ and systemd. See our Linux guide.

Verification and compatibility

Follow our verification instructions before installation. For updates, use your existing trusted verifier. For a first download, confirm the signing-key fingerprint through a separately trusted Blank Box channel. Python 3.10+ is needed for verification.

Catalog schema 20, metapack reader 5 and the four included starter metapacks are unchanged. Library recovery cannot recreate missing linked original files.

For setup help or feedback, open an issue. Please keep recovery keys, provider tokens and private library data out of public reports.

Assets 8
Loading