> ## Documentation Index
> Fetch the complete documentation index at: https://help.atlas.kitchen/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Atlas printer to WiFi

> Connect Atlas receipt printers to WiFi network. Choose manual browser pairing or QR pairing with WeChat for wireless printer setup.

Atlas printers can be connected to WiFi wirelessly using one of these two methods:

* Mode A: QR pairing with WeChat.

* Mode B: Manual pairing via browser (recommended).

<AccordionGroup>
  <Accordion title="Mode A: QR pairing with WeChat" defaultOpen={false}>
    Follow these steps to pair your printer using WeChat:

    1. Connect to the outlet's WiFi network (must be 2.4GHz).

    2. Download WeChat and create an account.

    3. Locate the small black button at the back of the printer.

    4. Press and hold the button for 2 seconds and release → A receipt will print.

    5. Repeat step 4 → A receipt will print with a QR code.

    6. Open WeChat and scan the QR code.

       * Note: This connects the printer to WiFi.

    7. Enter your WiFi password and confirm.

    * Note: Ensure Bluetooth and Local Network access are enabled if needed.

    8. On the next screen, select the Printer network and tap Connect.

    9. Wait for the printer to connect and print a success receipt.

    10. If the connection failed receipt prints, repeat the steps or check your WiFi stability.
  </Accordion>

  <Accordion title="Mode B: Manual pairing via browser (use phone, tablet, or laptop)" defaultOpen={true}>
    <Steps>
      <Step title="With the printer powered on, locate the small black button at the back of the printer.">
        <Frame caption="Button is very small — see the image above">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/printer-button.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=fd7d6a8a07a2cd53407f3e795101e7c6" alt="Atlas receipt printer showing small black pairing button location at the back of the device" width="572" height="431" data-path="images/hardware/printer-button.webp" />
        </Frame>
      </Step>

      <Step title="Press and hold the button for 2 seconds, then release → A receipt will print with two options">
        <Frame caption="First receipt that will print">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/receipt-1.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=a3869adff43d70814e45f15edfb94ccb" alt="Printer configuration receipt showing Mode A and Mode B pairing options after first button press" width="4032" height="3024" data-path="images/hardware/receipt-1.webp" />
        </Frame>
      </Step>

      <Step title="Press and hold the button again until another receipt prints. Do not release the button until it prints.">
        This enters Mode B: Manual WiFi pairing mode (lasts 5-10 minutes)

        <Frame caption="Second receipt that will print">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/receipt-2.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=1667687c571dc1a02aa4c52eecd14420" alt="Printer receipt confirming Mode B manual WiFi pairing mode is active with instructions" width="4032" height="3024" data-path="images/hardware/receipt-2.webp" />
        </Frame>
      </Step>

      <Step title="Open your device's WiFi settings and connect to network named 'Printer'">
        Wait until your device is connected. This network has no internet access, but that's fine for this setup.

        <Frame caption="Printer network will look like this in the WiFi available networks list">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/network.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=2563e9b4c6da92cec10e756f3542eb97" alt="Device WiFi settings showing Printer network in available networks list for connection" width="652" height="431" data-path="images/hardware/network.webp" />
        </Frame>
      </Step>

      <Step title="Open a browser and enter 10.10.100.254 in the search bar." />

      <Step title="When prompted, enter admin for both the username and password.">
        <Frame caption="This is the prompt that will ask you to enter admin as a user and password">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/sign-in-printer.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=e3f031968dbe324f986a90dd3238bace" alt="Printer configuration login prompt requesting admin username and password for access" width="323" height="253" data-path="images/hardware/sign-in-printer.webp" />
        </Frame>
      </Step>

      <Step title="Once inside the printer's configuration menu, click SCAN to see the available WiFi networks">
        You can change the language (Mandarin or English) from the top-right corner.

        <Frame caption="The SCAN button is located in the right corner too">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/printer-set-up.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=7bc932b9aaf7ce0882c2fe377431b17e" alt="Printer configuration interface showing SCAN button in top-right corner to detect available WiFi networks" width="772" height="631" data-path="images/hardware/printer-set-up.webp" />
        </Frame>
      </Step>

      <Step title="Select your WiFi network, click the dial button beside it, and then press OK.">
        <Frame caption="The list of available WiFi networks looks like this">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/select-wifi-printer.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=2eb1cb45d7ccb15a3f73e434cabe22c3" alt="Printer WiFi network selection screen displaying list of available networks with radio buttons and OK button" width="772" height="589" data-path="images/hardware/select-wifi-printer.webp" />
        </Frame>

        A prompt saying the password is empty will come up. Just press ok, and move to the next step.
      </Step>

      <Step title="Enter your WiFi password, click Show Password to confirm it's correct, and press Save.">
        <Frame caption="Enter your password and make sure it is correct.">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/enter-pw-printer.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=236c8d8b83d925c5c3d95f50f068fa50" alt="Printer WiFi password entry screen with password field, Show Password checkbox, and Save button" width="783" height="601" data-path="images/hardware/enter-pw-printer.webp" />
        </Frame>
      </Step>

      <Step title="Click Restart to finalise the connection.">
        <Frame caption="Press restart to finish this up.">
          <img src="https://mintcdn.com/atlaskitchen/PbQq0fyxwtbdSf_o/images/hardware/finish-printer-setup.webp?fit=max&auto=format&n=PbQq0fyxwtbdSf_o&q=85&s=e8f7448d116cdec1632e6cbeb3b146e9" alt="Printer configuration confirmation screen with Restart button to finalise WiFi connection setup" width="778" height="589" data-path="images/hardware/finish-printer-setup.webp" />
        </Frame>
      </Step>
    </Steps>

    Within a few minutes, a successful connection receipt should print. *This may take up to 10 minutes in some cases.*

    If a connection failed receipt prints instead, go through the guide again and ensure all steps were followed correctly. Also, check your WiFi stability.
  </Accordion>
</AccordionGroup>

## What should happen

After completing the WiFi setup:

* The printer prints a "Connection Successful" receipt showing it's connected to your WiFi network
* The printer appears in Atlas Merchant Portal under your outlet's printer settings
* You can send test prints from Atlas POS or the Merchant Portal

## If it doesn't work

<AccordionGroup>
  <Accordion title="Printer prints 'Connection Failed' receipt">
    1. Verify your WiFi password is correct — re-enter it carefully
    2. Check that your WiFi network is 2.4GHz (not 5GHz) — the printer only supports 2.4GHz
    3. Move the printer closer to your WiFi router
    4. Check if your WiFi network has a captive portal (login page) — the printer cannot connect to networks requiring browser login
    5. Restart your WiFi router and try again
  </Accordion>

  <Accordion title="Can't connect to the 'Printer' WiFi network">
    1. Make sure you're in Mode B (manual pairing mode) — press and hold the button until the second receipt prints
    2. The printer's WiFi mode only lasts 5-10 minutes. If it timed out, press the button again to re-enter pairing mode
    3. Check that your phone/tablet WiFi is turned on
    4. If "Printer" doesn't appear in your WiFi list, restart the printer and try again
  </Accordion>

  <Accordion title="Browser shows 'Cannot connect' when entering 10.10.100.254">
    1. Make sure you're connected to the "Printer" WiFi network (not your regular WiFi)
    2. Wait 10-15 seconds after connecting before opening the browser
    3. Type the address exactly: `10.10.100.254` — no "http\://" or "www"
    4. Try a different browser if the first one doesn't work
    5. Disable any VPN on your device
  </Accordion>

  <Accordion title="Login prompt asks for username/password and 'admin' doesn't work">
    1. Try lowercase `admin` for both username and password
    2. If the printer was previously configured, it may have a different password. Factory reset the printer and try again
    3. Check your printer documentation for default credentials
  </Accordion>

  <Accordion title="WiFi network list is empty when clicking SCAN">
    1. Wait 10-15 seconds and tap SCAN again
    2. Check that your WiFi router is powered on and broadcasting
    3. Move the printer closer to the router
    4. Your WiFi may be set to "hidden" — you'll need to enter the network name manually
  </Accordion>

  <Accordion title="Printer connected but doesn't print from Atlas">
    1. In Atlas Merchant Portal, go to **Settings > Printers** and verify the printer is listed
    2. Check that the printer is assigned to the correct outlet and station
    3. Send a test print from Atlas to verify the connection
    4. Restart the printer and check if it reconnects
    5. Contact support at [hello@atlas.kitchen](mailto:hello@atlas.kitchen) if the printer still doesn't appear
  </Accordion>
</AccordionGroup>

## Next steps

* [Set up Atlas POS](/get-started/installing-atlas) — Install Atlas on your tablet
* [Configure your outlet](/merchant-portal/operating-hours) — Set operating hours and menu
* [Start taking orders](/merchant-portal/admin-orders) — Create your first order