Download

How can we help?

Find answers to common questions, troubleshooting guides, and documentation for Chat Local.

Getting Started

Everything you need to know to start using Chat Local

📱 Installation

Step 1: Open the App Store on your iPhone or iPad.

Step 2: Search for "Chat Local" in the search bar.

Step 3: Tap the "Get" button next to the Chat Local app.

Step 4: Authenticate with Face ID, Touch ID, or your Apple ID password.

Step 5: Wait for the download to complete, then tap "Open" or find the app on your home screen.

Step 6: On first launch, accept the Terms of Service and Privacy Policy to continue.

Step 1: Open the Google Play Store on your Android device.

Step 2: Search for "Chat Local" using the search bar at the top.

Step 3: Tap the "Install" button on the Chat Local app page.

Step 4: Wait for the download and installation to complete.

Step 5: Tap "Open" or find the app in your app drawer.

Step 6: On first launch, accept the Terms of Service and Privacy Policy to continue.

Chat Local requires the following permissions to function:

  • Bluetooth: Required to discover and connect to nearby devices. This is essential for all messaging features.
  • Location (Android only): Android requires location permission to scan for Bluetooth devices. Chat Local does not track or store your location.
  • Notifications: Optional, but recommended to receive alerts when new messages arrive.

You'll be prompted to grant these permissions when you first open the app. If you declined them, go to Settings → Apps → Chat Local → Permissions to enable them.

On iOS:

  • Open Settings → Bluetooth and ensure Bluetooth is turned ON.
  • Chat Local will request permission to use Bluetooth on first launch — tap "OK" to allow.

On Android:

  • Swipe down from the top of the screen and tap the Bluetooth icon to enable it.
  • Alternatively, go to Settings → Connected devices → Connection preferences → Bluetooth and turn it ON.
  • When Chat Local requests Bluetooth permission, tap "Allow".

Tip: For best results, keep Bluetooth on while using Chat Local. The app uses Bluetooth Low Energy (BLE), which has minimal impact on battery life.

💬 Conversations

Step 1: Tap the "+" button in the top right corner of the Conversations tab.

Step 2: Enter a unique Conversation ID (3-20 characters). This is like a room name — share it with others so they can join.

Step 3: Enter your display name (how others will see you in the chat).

Step 4: Choose the protocol (Bluetooth is currently the only option).

Step 5: (Pro only) Optionally enable end-to-end encryption and set a password.

Step 6: Tap "Join Conversation" to create and enter the chat.

Tip: Choose memorable but unique Conversation IDs like "family-reunion-2026" or "team-blue-concert".

To join an existing conversation, you need to know the Conversation ID:

Step 1: Tap the "+" button in the top right corner of the Conversations tab.

Step 2: Enter the exact Conversation ID that was shared with you.

Step 3: Enter your display name.

Step 4: If the conversation is password-protected, enter the password.

Step 5: Tap "Join Conversation".

You can also join from the Nearby tab — see "Discovering Nearby Chats" below.

The Nearby tab shows active conversations from nearby Chat Local users:

Step 1: Tap the "Nearby" tab at the bottom of the screen.

Step 2: The app will scan for nearby devices and display active conversations.

Step 3: You'll see a preview of each conversation (limited messages for Free users).

Step 4: Tap on a conversation to see more details.

Step 5: Tap "Join" to enter the conversation.

Note: Password-protected conversations will appear but require the correct password to read messages or join.

To leave a conversation:

  • Open the conversation, tap the menu icon (⋮) in the top right.
  • Select "Leave Conversation".
  • Confirm your choice. You can rejoin later using the same Conversation ID.

To delete a conversation from your device:

  • On the Conversations tab, swipe left on the conversation you want to delete.
  • Tap the "Delete" button.
  • Confirm deletion. This only removes it from your device — others in the conversation are unaffected.

🔐 Security & Privacy

Chat Local uses AES-256-GCM encryption, a military-grade encryption standard:

  • Default encryption: All messages are automatically encrypted using app-level keys. This protects messages from being read by devices they hop through in the mesh network.
  • Password encryption (Pro): You can add an additional layer of security by setting a password. Only people with the correct password can decrypt and read messages.

Encryption happens on your device before messages are sent, and decryption happens on the receiving device. No servers or third parties ever see your unencrypted messages.

Pro users can create conversations with password protection:

Creating a protected chat:

  • When creating a new conversation, toggle "End-to-End Encryption" ON.
  • Enter a strong password or tap "Generate" for a random secure phrase.
  • Share the password securely with your group (in person, secure messenger, etc.).

Joining a protected chat:

  • Enter the Conversation ID and password when joining.
  • If you enter the wrong password, you cannot read any messages.

Important: We cannot recover forgotten passwords. If you lose the password, create a new conversation.

Chat Local is designed with privacy as a core principle:

  • No accounts: We don't collect your email, phone number, or personal information.
  • No servers: Messages travel directly between devices. We have no servers to store or access your conversations.
  • Local storage: Messages are stored only on your device. Uninstalling the app removes all data.
  • No tracking: We don't track your location, contacts, or usage patterns.
  • Crash reports: Anonymous crash reports help us fix bugs. No personal data is included.

Read our full Privacy Policy for complete details.

Pro users can block specific users or devices to prevent receiving their messages:

To block a user:

  • In a conversation, tap and hold on a message from the user you want to block.
  • Select "Block User" from the menu.
  • Confirm the block. You will no longer see messages from this user.

To manage blocked users:

  • Go to Settings → Blocked Users.
  • View your blocked list and tap "Unblock" to remove blocks.

Note: Blocking is local to your device. The blocked user can still send messages, but you won't see them.

⚙️ Settings & Customization

Pro users can customize the app's appearance:

Step 1: Go to Settings (tap the gear icon).

Step 2: Tap "Appearance" or "Theme".

Step 3: Choose from available themes or colors.

Step 4: Your selection is applied immediately.

You can also toggle between Light, Dark, and System modes to match your device settings.

Customize how and when Chat Local notifies you:

Step 1: Go to Settings → Notifications.

Step 2: Toggle notifications on or off for different events:

  • New messages in your conversations
  • New nearby conversations discovered
  • Keyword alerts (Pro) — get notified when specific words are mentioned

System settings: You can also manage notifications in your device's Settings → Apps → Chat Local → Notifications.

Control how profanity is handled in conversations:

Free users: The profanity filter is enabled by default and cannot be changed.

Pro users:

  • Go to Settings → Content Filters.
  • Toggle "Profanity Filter" on or off.
  • When enabled, profanity is automatically replaced with asterisks (****).

Note: The filter only affects how messages display on your device. Other users see messages based on their own filter settings.

Chat Local Pro unlocks powerful features:

  • Unlimited conversations: Create or join as many conversations as you want (Free: 2).
  • Extended history: See 500+ messages per conversation (Free: 20).
  • Password encryption: Secure conversations with custom passwords.
  • Block users: Prevent specific users from messaging you.
  • Custom themes: Personalize the app's appearance.
  • Profanity control: Toggle the profanity filter on or off.
  • Faster messaging: Reduced rate limits between messages.

Pricing: $1.99/week, $4.99/month, or $24.99/year (save 58%).

Upgrade in the app under Settings → Upgrade to Pro.

Frequently Asked Questions

Quick answers to common questions

Chat Local is a peer-to-peer messaging app that uses Bluetooth mesh networking to connect you with people nearby. Unlike traditional messaging apps, Chat Local doesn't require WiFi, cellular data, or any internet connection. Messages travel directly between devices using Bluetooth, and can hop through multiple devices to extend range.

Direct Bluetooth range is typically 50-100 meters (150-300 feet) in open areas, less in buildings. However, Chat Local uses mesh networking — your messages can hop through other nearby Chat Local users, potentially extending range much further. The more people using Chat Local nearby, the further your messages can travel.

No! Chat Local doesn't require any account, email, phone number, or personal information. Simply download the app, pick a display name, and start chatting. Your privacy is protected because we don't collect any personal data.

Conversation IDs are like room names. Anyone who knows the ID can join the conversation. IDs must be 3-20 characters and can contain letters, numbers, hyphens, and underscores. Share the ID with friends to let them join your chat. Example IDs: family-trip, team-alpha, concert2026

Make sure:

  • Bluetooth is turned ON in your device settings
  • You've granted Chat Local permission to use Bluetooth
  • The other device also has Chat Local open and running
  • Both devices are within Bluetooth range (typically 50-100m)
  • Try closing and reopening the app

Chat Local uses Bluetooth Low Energy (BLE), which is designed for minimal battery consumption. However, keeping Bluetooth active does use some battery. For best results, keep your phone charged at events, or close the app when not actively chatting.

Mesh networking means your messages can hop between multiple devices to reach their destination. If you're too far from someone to connect directly, but there are Chat Local users between you, your message will automatically route through them. Each message has a "hop limit" (TTL) to prevent infinite routing.

Yes! Turn on airplane mode first, then turn Bluetooth back on. Chat Local will work perfectly since it only needs Bluetooth — no WiFi or cellular required. This is great for flights, remote areas, or any situation where you want to disconnect from the internet but stay connected locally.

Yes! All messages are encrypted using AES-256-GCM, a military-grade encryption standard. There are two levels of encryption:

  • Default encryption: All messages are automatically encrypted using app-level keys
  • Password encryption (Pro): Create password-protected conversations that only people with the password can read

Messages are encrypted so they can't be read by devices they hop through. However, anyone who knows your conversation ID can join and see future messages (unless you use password protection). For private conversations, use the password encryption feature (Pro) to ensure only people with the password can decrypt and read messages.

Pro users can create conversations with a password. The password is used to derive an encryption key — everyone with the same password gets the same key and can read each other's messages. People with the wrong password (or no password) cannot decrypt the messages. Share the password securely with your group before they join.

No. Chat Local is completely serverless. Messages are stored only on your device and transmitted directly via Bluetooth. We don't have servers that receive, store, or process your messages. Your chat history exists only on devices that participated in the conversation.

Chat Local Pro unlocks:

  • Unlimited conversations (Free: 2)
  • Extended message history (500+ vs 20)
  • Password-protected (end-to-end encrypted) conversations
  • Custom themes and colors
  • Block users and devices
  • Control profanity filter
  • Faster message rate limits
  • Priority support

Subscriptions are managed through your device's app store:

  • iOS: Settings → [Your Name] → Subscriptions → Chat Local → Cancel
  • Android: Play Store → Menu → Subscriptions → Chat Local → Cancel

You'll keep Pro access until the end of your billing period.

Yes! Your Pro subscription is linked to your App Store or Google Play account. On your new device, go to Settings in Chat Local and tap "Restore Purchases". Make sure you're signed in with the same account you used to purchase.

Troubleshooting

Solutions to common issues

⚠️ "Bluetooth permission denied"

The app needs Bluetooth permission to discover nearby devices.

Solution:

Go to your device Settings → Apps → Chat Local → Permissions, and enable Bluetooth and Location (required for Bluetooth on Android).

⚠️ No nearby devices found

The app can't discover other Chat Local users.

Solution:

Ensure the other person has Chat Local open and active. Try moving closer (within 50m). On Android, make sure Location is enabled. Try pulling down to refresh the scan.

⚠️ Messages not sending

Messages show "Sending..." but never complete.

Solution:

Check that you're connected to at least one device (green status indicator). Make sure you haven't exceeded the rate limit (Free: 1 msg/5 sec). Try closing and reopening the app.

⚠️ Can't join password-protected chat

Password keeps being rejected.

Solution:

Passwords are case-sensitive. Make sure you have the exact password from the conversation creator. If you've entered wrong passwords 3 times, you may need to wait before trying again.

⚠️ App crashes on startup

Chat Local closes immediately after opening.

Solution:

Try force-closing the app and reopening. If that doesn't work, uninstall and reinstall the app. Your conversations are stored locally, but you may need to rejoin them.

⚠️ Missing messages in conversation

Some messages from others aren't appearing.

Solution:

Free users only see the most recent 20 messages. If you're in a password-protected chat, ensure you have the correct password. Messages sent when you were out of range won't be received.

Understanding Chat Local

What the app is designed for — and what it's not

✅ Chat Local IS...

  • A way to message people nearby without internet
  • Perfect for events, travel, and emergencies
  • An encrypted, private messaging tool
  • A mesh network that extends range through nearby users
  • Completely serverless — no data stored in the cloud
  • Usable without accounts, phone numbers, or sign-ups
  • Battery-efficient using Bluetooth Low Energy

❌ Chat Local is NOT...

  • A replacement for internet-based messaging (iMessage, WhatsApp, etc.)
  • Able to send messages across long distances without nearby users
  • A guaranteed delivery system — messages require nearby devices
  • Able to send images, videos, or files (text only)
  • Connected to any social network or contact list
  • Syncing across your devices — each device is independent
  • Working when the app is closed or in the background

Still Need Help?

Our support team is here for you

📧

Email Support

Get a response within 24-48 hours

Send Email
💡

Feature Requests

Have an idea? We'd love to hear it!

Suggest Feature
🐛

Report a Bug

Found something broken? Let us know

Report Bug