Get new posts weekly

How to setup Firebase emulator with Flutter

Having previously setup our Firebase emulator with some nice fake data. We now have to connect our Flutter application to our emulator. This will give us the perfect environment to develop our application without racking up the bills.

Before we write any code, we will start the emulators. In your backend run the command

firebase emulators:start

This will print out all the local ports that we'll need to point to when setting up our emulator connection.

Log output starting emulators

Open main.dart and at the top of this file we'll have a new boolean to indicate emulator usage.

const bool USE_EMULATOR = true;

We will also create a new function that encapsulates all the Firebase emulator setup. The function will be quite basic. The first thing we'll do is make sure that we have the correct representation of localhost for the platform we are on. The Android emulators prefer if you refer to your local host as and the other platforms are happy with localhost. Once we have that we can set the local settings on the different Firebase features we want to use. In our case we want to point the FirebaseFirestore instance to local host port 8080 as shown in the logs above from starting the emulator. And for the FirebaseAuth we want to point it to port 9099.

/// Connnect to the firebase emulator for Firestore and Authentication
Future _connectToFirebaseEmulator() async {
  final localHostString = Platform.isAndroid ? '' : 'localhost';

  FirebaseFirestore.instance.settings = Settings(
    host: '$localHostString:8080',
    sslEnabled: false,
    persistenceEnabled: false,

  await FirebaseAuth.instance.useEmulator('http://$localHostString:9099');

When we can update our main function and if USE_EMULATOR is true we call _connectToFirebaseEmulator .

Future main() async {
  await Firebase.initializeApp();

    await _connectToFirebaseEmulator();


Now you can run your app (on a simulator or emulator) and use it normally. You'll see everything working the same, with the one change being that the Authentication and the Firestore instances being used is on the local Firebase Emulator.

If you get a clear test error, remember to add the allowClearText attribute to the AndroidManifest.xml application tag.

If you're like me and you like to debug on a real device then you'll need to make a few adjustments to the project to get it working. The first thing is to get your ip address of your computer, or an ip you can reference from outside of your network that points to your machine. Then you're going to open up your firebase.json file and add your host in there.

  "emulators": {
    "auth": {
      "host": "",
      "port": 9099
    "functions": {
      "port": 5001
    "firestore": {
      "host": "",
      "port": 8080
    "database": {
      "port": 9000
    "ui": {
      "enabled": true

Now when you run firebase emulators:start you'll see on the left side of your firebase logs (like the ones printed out at the start), in the Host:Port column you will now see the host that you've added in there.

Now you can go back to main.dart and update your localHostString to the host specified address.

final localHostString = '';

Now you'll be able to run the emulator on a real device. The reason I don't like using this method is because each dev has to update the host ports in the firebase.json file. As well as the host in the flutter code to match. This means get their ip address and add it every time code has been pulled or merged. So this is just here for completeness, I won't be setting up the code like this in the project. Each dev that requires it can go through the effort of adding their ip when hosting the emulator suite.

That's all for this week. Thanks for reading 🥰

Never miss a post again 🚀

Get weekly updates on new tutorials, discussions and new flutter features from our newsletter

Also check out

Cover image

Get results for user location - Part 1

This tutorial goes over checking users entered location and notifying them if we dont service the area

Cover image

An Advanced Flutter Dialog System

This tutorial goes over the process of setting up a custom dialog in your Flutter application

Cover image

How to plan for Product Development

This tutorial goes over the process a development team should take before writing code