Docs Menu

Docs HomeRealm

Troubleshooting - Flutter SDK

On this page

  • Use Realm with the macOS App Sandbox
  • Connect to App Services Using Android 7 or Older

If you are developing with the Realm Flutter SDK in the macOS App Sandbox, network requests do not work by default due to built-in macOS security settings. Network access is required to use Atlas App Services and Device Sync.

To enable network requests, add the following code to both the files macos/Runner/DebugProfile.entitlements and macos/Runner/Release.entitlements:

<!-- Other entitlements -->
<!-- Other entitlements -->

You can still use Realm locally without adding this network access permission.

For more information about Flutter development for macOS, refer to Building macOS apps with Flutter in the Flutter documentation.

To use App Services with the Realm SDK on a device using Android 7 or older, you must add an HTTP client with a custom Let's Encrypt Transport Layer Security (TLS) encryption certificate to the App.

This is due to a known issue using Flutter on devices running Android 7 or older to connect to web servers that use Let's Encrypt TLS certificates. As App Services server uses a Let's Encrypt TLS certificate, you must add the custom certificate.

You can download the Let's Encrypt certificate to add to your app by clicking this link:

To set up the custom HTTP client, adapt the following code example to your app.

import 'package:realm_dart/realm.dart';
import "dart:io";
import "dart:convert";
HttpClient createCustomHttpsClient(String cert) {
SecurityContext context = SecurityContext.defaultContext;
try {
final bytes = utf8.encode(cert);
} on TlsException catch (e) {
final message = e.osError?.message ?? "";
if (!message.contains('CERT_ALREADY_IN_HASH_TABLE')) {
return HttpClient(context: context);
App createAppWithCustomHttpsClient(
String letsEncryptCertificate, String appId) {
HttpClient httpClient = createCustomHttpsClient(letsEncryptCertificate);
final appConfig = AppConfiguration(appId, httpClient: httpClient);
return App(appConfig);
final letsEncryptCertificate = "<LET'S ENCRYPT CERTIFICATE>";
final appId = "<YOUR APP ID>";
final app = createAppWithCustomHttpsClient(letsEncryptCertificate, appId);
←  Stream Data to Atlas - Flutter SDKTest & Debug - Flutter SDK →
Share Feedback
© 2023 MongoDB, Inc.


  • Careers
  • Investor Relations
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2023 MongoDB, Inc.