Skip to main content

Setting Up Your Epson ePOS Receipt Printer

Your CloudFFL system is served over a secure HTTPS connection. Because of this, your browser requires that your receipt printer also communicate securely before it will allow the two to talk to each other. This is a one-time setup — once it's done on a computer, that computer can print receipts without any extra steps.

This guide covers the full setup for the Epson ePOS series of receipt printers (TM-T20, TM-T88, and similar models).

Who does this? This is a one-time IT or manager setup task — not something your cashiers need to do. Plan for about 5 minutes per computer.

What You'll Need

  • The printer's IP address (check your router or the printer's network settings printout)
  • The printer's serial number (printed on the label on the bottom of the printer)
  • Access to the computer(s) you'll use for POS

Step 1: Download the Certificate from the Printer

Your Epson printer has a built-in web page for configuration. You'll log in and download its security certificate from there.

  1. On any computer on your network, open your browser and go to https://[your-printer-ip] (for example: https://192.168.1.100). You'll see a security warning — this is expected at this step.
  2. Click Advanced and then Proceed to [IP address] to get past the warning.
  3. You'll be prompted to log in. Enter:
    • ID: epson
    • Password: your printer's serial number (found on the label on the bottom of the printer)
  4. In the left menu, click SSL/TLS under the Security section.
  5. Next to Server Certificate, confirm Self-Signed Certificate is selected. If no certificate exists yet, click Certificate List → Create, fill in the printer's IP as the Common Name, set the validity period to the maximum available, click Create, then restart the printer and return to this step.
  6. Click Certificate List, then click Export next to the self-signed certificate. Save the file to your Desktop — it will download as a .pem or .crt file.
Who Onlydoes create the certificate once.this? IfThis you generateis a newone-time certificate,IT you'llor manager setup task — not something your cashiers need to re-installdo. it on every POS computer. Set the validity period to the maximum (typically 10 years) so you don't have to repeat this processPlan for aabout long5 time.minutes per computer.

Step 2: Install the Certificate on Each POS Computer

Do this once on every computer that will be used to run POS. Choose the instructions for your operating system below.

On a Mac

  1. Double-click the certificate file you downloaded. Keychain Access will open automatically.
  2. In the keychain list on the left, make sure System is selected (not Login).
  3. Click Add when prompted to add the certificate.
  4. Enter your Mac password if asked.
  5. Find the newly added certificate in the list — it will be named after your printer's IP address. Double-click it to open it.
  6. Click the arrow next to Trust to expand that section.
  7. Change When using this certificate to Always Trust.
  8. Close the window and enter your Mac password again to save.
  9. Quit and relaunch your browser completely.

On Windows

  1. Right-click the certificate file you downloaded and select Install Certificate.
  2. When asked where to install it, select Local Machine and click Next. Approve the admin prompt if one appears.
  3. Select Place all certificates in the following store, then click Browse.
  4. Select Trusted Root Certification Authorities and click OK.
  5. Click Next, then Finish. You should see a confirmation that the import was successful.
  6. Close and relaunch your browser completely.

Chrome and Edge on Windows both use the Windows certificate store, so installing it once covers both browsers. Firefox uses its own store — if you use Firefox, you'll need to import the certificate separately under Firefox Settings → Privacy & Security → Certificates → Import.

Step 3: Configure the Printer in CloudFFL POS Settings

  1. Log into CloudFFL and go to Point of Sale → Configuration → Settings.
  2. Scroll down to the Connected Devices section and find your printer.
  3. Set the printer URL to https://[your-printer-ip] — for example: https://192.168.1.100. Make sure it starts with https://, not http://.
  4. Click Save.

Step 4: Test the Printer

  1. Open a POS session.
  2. The printer connection should establish automatically. If you see a test print or the session opens without a printer error, you're all set.

Testing tip: Complete a small $0.00 or voided test transaction to confirm the receipt actually prints before opening for the day.

Troubleshooting

  • Still seeing a connection error after installing the cert? Make sure you fully quit and relaunched the browser — not just closed the tab. On Mac, press Cmd+Q to fully quit Chrome or Safari.
  • Printer IP changed? If your printer gets a new IP address, you'll need to update the URL in POS settings. Consider setting a static IP for your printer in your router settings to avoid this.
  • Printer was factory reset? A factory reset wipes the certificate. You'll need to create a new one in the printer web interface and re-install it on all POS computers.
  • Multiple printers? Repeat Steps 1–2 for each printer, then configure each one separately in POS settings.
Back to top