summaryrefslogtreecommitdiffstats
path: root/content/en/hardenedpass/getting-started/install
diff options
context:
space:
mode:
authorDanilo M. <danix@danix.xyz>2026-11-05 10:22:12 +0100
committerDanilo M. <danix@danix.xyz>2026-11-05 10:22:12 +0100
commit395eed25a9d879391558026bb90cd3acb9afdacf (patch)
tree70e33dcdcca31fc47d595cd339778ebfa09ce6df /content/en/hardenedpass/getting-started/install
parenta5761e8d7875357d0dcc52a5cc31f06f866d791c (diff)
downloaddanixxyz-395eed25a9d879391558026bb90cd3acb9afdacf.tar.gz
danixxyz-395eed25a9d879391558026bb90cd3acb9afdacf.zip
content: write HardenedPass getting-started pages
Concepts, install, creating a store from zero and connecting the app, in both languages, with screenshots from the test store. Still drafts. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Diffstat (limited to 'content/en/hardenedpass/getting-started/install')
-rw-r--r--content/en/hardenedpass/getting-started/install/index.md60
1 files changed, 56 insertions, 4 deletions
diff --git a/content/en/hardenedpass/getting-started/install/index.md b/content/en/hardenedpass/getting-started/install/index.md
index 116df07..627261e 100644
--- a/content/en/hardenedpass/getting-started/install/index.md
+++ b/content/en/hardenedpass/getting-started/install/index.md
@@ -1,13 +1,65 @@
+++
title = "Install"
date = 2026-11-05T00:00:00Z
-description = ""
+description = "How to download the HardenedPass APK from GitHub Releases, verify its checksum and signing certificate, install it and update it."
weight = 20
draft = true
+++
-Placeholder.
+HardenedPass needs Android 8 or newer and works without Google Play Services. It is
+not on an app store: you install the APK from the project's releases.
-## First heading
+## Download
-Text.
+Open the [latest release](https://github.com/danixland/HardenedPass/releases/latest)
+and download both files:
+
+- `HardenedPass_vX.Y.Z.apk`, the app
+- `HardenedPass_vX.Y.Z.apk.sha256`, its checksum
+
+## Verify the download
+
+This step needs a computer, and it is worth doing: a password manager is a bad thing
+to install from a tampered file.
+
+Check that the file arrived intact:
+
+```bash
+sha256sum -c HardenedPass_vX.Y.Z.apk.sha256
+```
+
+The output must end in `OK`.
+
+Then check who signed it. `apksigner` is part of the Android SDK build tools:
+
+```bash
+apksigner verify --print-certs HardenedPass_vX.Y.Z.apk
+```
+
+The `certificate SHA-256 digest` line must read:
+
+```
+725016669e482f9ac371dee8df19a2a1b34fa76d1af05b2a23784725b1b49c83
+```
+
+If either check fails, do not install the file.
+
+## Install
+
+Copy the APK to the phone and open it from the file manager. Android asks you to allow
+installs from that app the first time. Allow it, install, then turn the permission off
+again if you prefer.
+
+HardenedPass has its own application ID, so it installs next to Android Password Store
+instead of replacing it. The two share no data: to move over, set HardenedPass up
+as described in [Connect the app]({{< relref "/hardenedpass/getting-started/connect" >}}).
+
+## Update
+
+The app does not check for updates. To follow new versions, watch the
+[releases page](https://github.com/danixland/HardenedPass/releases) or its
+[Atom feed](https://github.com/danixland/HardenedPass/releases.atom).
+
+To update, verify the new APK the same way and install it over the old one. Your store
+and keys stay in place. Android refuses an update signed with a different key, which
+is one more check on top of yours.