Skip to content

Commit 8280e05

Browse files
author
Lee Miller
committed
Added some notes on the appimages into the install doc
1 parent 638b5a9 commit 8280e05

File tree

1 file changed

+32
-1
lines changed

1 file changed

+32
-1
lines changed

INSTALL.md

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,42 @@
22
- Binary (64bit, no separate installation of dependencies required)
33
- Windows: https://download.bitmessage.org/snapshots/
44
- Linux AppImages: https://artifacts.bitmessage.at/appimage/
5-
- Linux snaps: https://artifacts.bitmessage.at/snap/
5+
- Linux snaps: https://artifacts.bitmessage.at/snap/
66
- Mac (not up to date): https://github.com/Bitmessage/PyBitmessage/releases/tag/v0.6.1
77
- Source
88
`git clone git://github.com/Bitmessage/PyBitmessage.git`
99

10+
## Notes on the AppImages
11+
12+
The [AppImage](https://docs.appimage.org/introduction/index.html)
13+
is a bundle, built by the
14+
[appimage-builder](https://github.com/AppImageCrafters/appimage-builder) from
15+
the Ubuntu Bionic deb files, the sources and `bitmsghash.so`, precompiled for
16+
3 architectures, using the `packages/AppImage/AppImageBuilder.yml` recipe.
17+
18+
When you run the appimage the bundle is loop mounted to a location like
19+
`/tmp/.mount_PyBitm97wj4K` with `squashfs-tools`.
20+
21+
The appimage name has several informational filds:
22+
```
23+
PyBitmessage-<VERSION>-g<COMMITHASH>[-alpha]-<ARCH>.AppImage
24+
```
25+
26+
E.g. `PyBitmessage-0.6.3.2-ge571ba8a-x86_64.AppImage` is an appimage, built from
27+
the `v0.6` for x86_64 and `PyBitmessage-0.6.3.2-g9de2aaf1-alpha-aarch64.AppImage`
28+
is one, built from some development branch for arm64.
29+
30+
You can also build the appimage with local code. For that you need installed
31+
docker:
32+
33+
```
34+
$ docker build -t bm-appimage -f .buildbot/appimage/Dockerfile .
35+
$ docker run -t --rm -v "$(pwd)"/dist:/out bm-appimage .buildbot/appimage/build.sh
36+
```
37+
38+
The appimages should be in the dist dir.
39+
40+
1041
## Helper Script for building from source
1142
Go to the directory with PyBitmessage source code and run:
1243
```

0 commit comments

Comments
 (0)