Skip to content

docs: add ConnectBot installation verification guide #458

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kruton merged 1 commit into from
Oct 16, 2026
Merged

docs: add ConnectBot installation verification guide #458

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions .gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,9 @@ out/
# misc
.DS_Store
*.pem
!/public/certificates/connectbot-transparency.pem
!/public/certificates/connectbot-play-app-signing.pem
!/public/certificates/connectbot-github-apk-signing.pem
Thumbs.db

# debug
Expand Down
3 changes: 3 additions & 0 deletions public/_headers
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
/certificates/*.pem
Content-Type: application/pem-certificate-chain
Content-Disposition: attachment
12 changes: 12 additions & 0 deletions public/certificates/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# ConnectBot public verification certificates

These files contain public X.509 certificates, not private signing keys.

| File | Purpose | SHA-256 certificate fingerprint |
| --- | --- | --- |
| `connectbot-transparency.pem` | Verify code transparency for Google and OSS releases | `909e650add6ddce32b2307d5aa141f8cdb1bdf455d89388b2f53f8c30fdb0c61` |
| `connectbot-github-apk-signing.pem` | Original APK signing certificate for APKs published on GitHub | `aa43746a46127842169f8176412a1f4b1b1e2f8ad9e15aba217c3822dbeb2d5f` |
| `connectbot-play-app-signing.pem` | APK app-signing certificate for Google Play installations | `aa43746a46127842169f8176412a1f4b1b1e2f8ad9e15aba217c3822dbeb2d5f` |

Follow [Verify your ConnectBot installation](https://connectbot.org/guides/verify-installation/)
for the user-facing instructions.
15 changes: 15 additions & 0 deletions public/certificates/connectbot-github-apk-signing.pem
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
-----BEGIN CERTIFICATE-----
MIICUTCCAbqgAwIBAgIESQKviDANBgkqhkiG9w0BAQUFADBtMQswCQYDVQQGEwJV
UzEPMA0GA1UECBMGS2Fuc2FzMRAwDgYDVQQHEwdTaGF3bmVlMRMwEQYDVQQKEwpD
b25uZWN0Qm90MREwDwYDVQQLEwhSZWxlYXNlczETMBEGA1UEAxMKS2VubnkgUm9v
dDAeFw0wODEwMjUwNTMyNTZaFw0zNjAzMTIwNTMyNTZaMG0xCzAJBgNVBAYTAlVT
MQ8wDQYDVQQIEwZLYW5zYXMxEDAOBgNVBAcTB1NoYXduZWUxEzARBgNVBAoTCkNv
bm5lY3RCb3QxETAPBgNVBAsTCFJlbGVhc2VzMRMwEQYDVQQDEwpLZW5ueSBSb290
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDxRU6PqlwpKKUB8+rv7CXSUj3e
d71zGKLMwW7l+T90IjEZqjnmNTg2sC+jcPKrklkQhJJQwkOhHxv1h8VaSK1+kxzd
yMQ+h21nb1uTkMRVdmTjI0OU8ULq0D/krzV+oQCsbSHqIe7r4GXxShKZvWNsq/+7
5u6nEC0ob8yIOu2I0QIDAQABMA0GCSqGSIb3DQEBBQUAA4GBAKxQ7gDKj+XBMPSF
zrRwtbBjk4jLN8q1HQsIGSUtitL4TXIIXRSQnNjEEDfmgzmxc7zsBw9CPM2YwD/y
zKWtrMQzLR4FLkt/8IGm+covru2xpiDGZOADFcq8iBx/utfSKSvfup3zteraPjwr
WoITYF0MjGEwCOwSXbVo3EEyy7EK
-----END CERTIFICATE-----
15 changes: 15 additions & 0 deletions public/certificates/connectbot-play-app-signing.pem
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
-----BEGIN CERTIFICATE-----
MIICUTCCAbqgAwIBAgIESQKviDANBgkqhkiG9w0BAQUFADBtMQswCQYDVQQGEwJV
UzEPMA0GA1UECBMGS2Fuc2FzMRAwDgYDVQQHEwdTaGF3bmVlMRMwEQYDVQQKEwpD
b25uZWN0Qm90MREwDwYDVQQLEwhSZWxlYXNlczETMBEGA1UEAxMKS2VubnkgUm9v
dDAeFw0wODEwMjUwNTMyNTZaFw0zNjAzMTIwNTMyNTZaMG0xCzAJBgNVBAYTAlVT
MQ8wDQYDVQQIEwZLYW5zYXMxEDAOBgNVBAcTB1NoYXduZWUxEzARBgNVBAoTCkNv
bm5lY3RCb3QxETAPBgNVBAsTCFJlbGVhc2VzMRMwEQYDVQQDEwpLZW5ueSBSb290
MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDxRU6PqlwpKKUB8+rv7CXSUj3e
d71zGKLMwW7l+T90IjEZqjnmNTg2sC+jcPKrklkQhJJQwkOhHxv1h8VaSK1+kxzd
yMQ+h21nb1uTkMRVdmTjI0OU8ULq0D/krzV+oQCsbSHqIe7r4GXxShKZvWNsq/+7
5u6nEC0ob8yIOu2I0QIDAQABMA0GCSqGSIb3DQEBBQUAA4GBAKxQ7gDKj+XBMPSF
zrRwtbBjk4jLN8q1HQsIGSUtitL4TXIIXRSQnNjEEDfmgzmxc7zsBw9CPM2YwD/y
zKWtrMQzLR4FLkt/8IGm+covru2xpiDGZOADFcq8iBx/utfSKSvfup3zteraPjwr
WoITYF0MjGEwCOwSXbVo3EEyy7EK
-----END CERTIFICATE-----
25 changes: 25 additions & 0 deletions public/certificates/connectbot-transparency.pem
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
-----BEGIN CERTIFICATE-----
MIIEJTCCAo2gAwIBAgIUR9nvG0gBu8lsB7Hd+LmruhgHS3owDQYJKoZIhvcNAQEL
BQAwIjEgMB4GA1UEAwwXQ29ubmVjdEJvdCB0cmFuc3BhcmVuY3kwHhcNMjYxMDE1
MjI0MDE5WhcNMzYxMDEyMjI0MDE5WjAiMSAwHgYDVQQDDBdDb25uZWN0Qm90IHRy
YW5zcGFyZW5jeTCCAaIwDQYJKoZIhvcNAQEBBQADggGPADCCAYoCggGBAMRAAwpO
lvtqR4N+4Tmi4YL3YVUePP91rgoQB53V1laTxFsZGFRtcWycCHzYAY/tJAUP9PQp
fYPBqMjk8ryvR4gH8wXzZF7IHQVx2wzj3c2H86oBXcNiKvnwrsGzimzhM3SUKiKs
daemPSeBJ4hv5K09i7mFqydiEPMpzOUtLEqePAmX9nSaNa8F+xk9sMYkt+uC7X4y
F158S2ZASMCUOnUYCJIJSZ5LCng5rV71ssU7nVQQTvZveQAyGZnBRhS3we9wYozE
fEF30QsyWZsM+AE7RCTa5Hw/PZUpA7zD2ACy0xnuqTsgug+qEcheGqzoRJiIlxgk
bXBY7+Pw0wLoYQG7xHxbnZC3mK+uW9oOfHYcxlMs6M31YzIkukvJ5nLAPfD42vV1
RPyuhic/4t1egp9nNzeW2JpgMbHj2t3CAxpunU1f6XO2lgGMoBbRT736tAP23M0o
1KRXXrQPYoRxvdCHFqpvnAojbc9ug7X04gteP3gzkCNOsH57TYpPVrkYtwIDAQAB
o1MwUTAdBgNVHQ4EFgQUAEX0MyTl3uy2dJcRfr8v1mAQxQcwHwYDVR0jBBgwFoAU
AEX0MyTl3uy2dJcRfr8v1mAQxQcwDwYDVR0TAQH/BAUwAwEB/zANBgkqhkiG9w0B
AQsFAAOCAYEAa7d2jPPk8uUotWAndGRS1b1H242mvFCgY3slog7Ipmgt2FZAK0tZ
Wjm/eF4xjc0Nsb/bi0g5yT5l7uys2JdVvIXr0xlaFdaeZ97KSFDnAoJ+/rGBcIAF
lgDjFPcEpLX+X4L//sXWfGrDWwJTFc2/wdDyAyKIuVVp7WkvTKluepr8Hl941VH5
M+yfpkcMRJY3JLWqf6l74TlqG0uC4D2RS7tm2t/xBz9R7L99y6862kx4javyChGq
d6BD1rQZPY4pE/h20vhsn/Plw5uoy50C1TgN5fDcxgHlSIUaisvtDnbVpjnYTvnu
7LfttoC40vHMX5BakjHucdbiFb1cfyCOjKXbhCf81AKmcPxDIbsvnUVuPnbzkhrs
6yu14zTy2Ll38m3qUaA9krAINLVOQH2arcBTVOjz2IL7JfaIB9rjIju3W/Wu8dOP
LcM8IbvGwuLbsa8m4XE1qbOdi+235OlbQRFdAPHlg0FfZ+uo2MZaBhl3S9XDGBr2
a2ZHvaGdSDJo
-----END CERTIFICATE-----
2 changes: 2 additions & 0 deletions src/content/download.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ Scan this code with your phone's camera to open the Google Play listing:

Once installed, [connect to your first server](/guides/add-host/). You'll need a reachable server with SSH enabled and your own account credentials.

To check an installation from Google Play or GitHub Releases, follow [Verify your ConnectBot installation](/guides/verify-installation/).

## Early builds

ConnectBot is under active development. If you want to get an early build, you can join the open testing group (a.k.a., beta testers). You can also go to the next level and join the closed testing group (a.k.a., alpha testers).
Expand Down
8 changes: 7 additions & 1 deletion src/content/guides/index.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ title: Guides

# Guides

Start with a working connection, then make terminal input comfortable. Existing walkthroughs include written steps, a demonstration, and an interactive tour.
Start with a working connection, then make terminal input comfortable. Guides include written instructions; some also have a demonstration and an interactive tour.

[Download ConnectBot](/download/). You'll need your own SSH server and account credentials.

Expand Down Expand Up @@ -47,3 +47,9 @@ Combine text matching, commands, special keys, waits, and port-forward controls
### [How do I change terminal colors and font size?](./terminal-appearance/)

Create a reusable profile and give your terminal a comfortable, readable appearance.

## Security

### [How do I verify my ConnectBot installation?](./verify-installation/)

Check a Google Play or GitHub Releases installation against ConnectBot's public signing certificates, then optionally trace its code to a GitHub build.
Loading
Loading