Skip to content

Colota - Android GPS Location tracker

docs: add security overview page

Max Dietrich7f3eb8a3fc1a
diff --git a/apps/docs/docs/security.md b/apps/docs/docs/security.md
new file mode 100644
index 00000000..677f11e0
--- /dev/null
+++ b/apps/docs/docs/security.md
@@ -0,0 +1,32 @@
+---
+sidebar_position: 12
+---
+
+# Security
+
+An overview of how Colota handles your data at rest, in transit and on-device.
+
+## Data in Transit
+
+HTTPS is enforced for all public server endpoints. HTTP is only allowed for private/local network addresses (`192.168.x.x`, `10.x.x.x`, `172.16-31.x.x`, `100.64.x.x`, `localhost`) to support self-hosted setups. Self-signed TLS certificates are supported by installing your CA certificate on the device via Android system settings.
+
+## Credentials at Rest
+
+Authentication credentials (Basic auth, Bearer tokens, custom headers) are stored using Android's [`EncryptedSharedPreferences`](https://developer.android.com/reference/androidx/security/crypto/EncryptedSharedPreferences) with **AES-256-GCM** encryption. Credentials never leave the device except as HTTP headers sent to your configured endpoint.
+
+Sensitive values (Authorization, Bearer, Token, API-Key) are automatically masked in log exports.
+
+## Location Data at Rest
+
+Location history is stored in a local SQLite database on the device. The database is **not encrypted**. This means someone with physical access to a rooted device could read the data. For a self-hosted app where the user controls both the device and the server, this is a reasonable tradeoff.
+
+The database is not accessible to other apps (standard Android sandboxing).
+
+## What Colota Does Not Do
+
+- No analytics, telemetry or crash reporting
+- No advertising SDKs or tracking pixels
+- No data shared with the developer or third parties
+- No personal identifiers, device IDs or advertising IDs collected
+
+For the full privacy policy, see the [Privacy Policy](/privacy-policy).
diff --git a/apps/docs/sidebars.ts b/apps/docs/sidebars.ts
index 2a72bb81..656a0811 100644
--- a/apps/docs/sidebars.ts
+++ b/apps/docs/sidebars.ts
@@ -70,6 +70,11 @@ const sidebars: SidebarsConfig = {
id: "alternatives",
label: "Alternatives"
},
+ {
+ type: "doc",
+ id: "security",
+ label: "Security"
+ },
{
type: "doc",
id: "faq",