Skip to content

Installation

KiotViet installation guide: from account signup to printers and barcode scanners

A step-by-step guide to installing KiotViet in the right order: sign up, configure the store, install the desktop or mobile app, then connect a receipt printer and a barcode scanner.

Installing KiotViet actually means three separate things: signing up and configuring the store in a browser, installing an app on a computer or phone if you need offline use or in-store printing, and connecting hardware like a receipt printer or barcode scanner. This guide follows that order.

KiotViet runs in the browser — you don't always need to "install" anything

Unlike older accounting or POS software, KiotViet is a browser-based retail management platform. Store owners can log in and handle the entire workflow — sales, inventory, customers, reports — directly in Chrome or Edge without downloading anything. A real installation is only needed when:

  • The store wants a dedicated Windows/Mac app that can keep running over the local network when the Internet goes down, or needs specialized screens such as Kitchen and Reception (common for restaurants and cafés).
  • Staff use a phone instead of a computer and need the KiotViet mobile app.
  • The store has a receipt printer, a barcode-label printer, or a barcode scanner that needs to be connected to the software.

If you only need basic sales through a computer that already has a browser, you can skip the desktop app section and go straight to store setup.

Step 1: Register an account and create a store

  1. On the KiotViet homepage, choose the trial or sign-up option (usually shown as a "Free trial" button).
  2. Fill in personal details: full name, phone number, region, and the SMS verification code.
  3. Select your business type (retail, restaurant/café, spa/salon, hotel, etc.) — KiotViet uses this to show the interface and features suited to that industry.
  4. Set a store name and login password.
  5. Confirm store creation; the system then takes you to the management dashboard to start configuration.

On a phone, the flow is similar: download the KiotViet app from the App Store or Google Play, choose to create a new account, and fill in the same information.

Step 2: Initial store setup

Once the account exists, open Settings in the management dashboard to configure the store before selling anything for real. This step determines whether the software behaves the way you expect, and covers:

  • Store information: name, address, and logo shown on printed receipts.
  • Branches and warehouses: if you run more than one location, declare each branch and its corresponding warehouse.
  • Product catalog: units, product groups, barcodes, attributes (size, color, etc.).
  • Staff and permissions: separate login accounts for each cashier.
  • Receipt templates: paper size and the content printed on receipts.
  • Utility connections: shipping partners, payment gateways, SMS/Zalo, if the store needs them.

It's worth finishing store information and receipt templates first, since they directly affect the receipt a customer receives at checkout.

Installing KiotViet on a computer

Use it directly in a browser

Log in to KiotViet's management URL with the account you created — nothing to install. This works fine for a typical retail store with one computer or POS machine and a stable Internet connection.

Installing the KiotViet Cashier desktop app

If you need offline operation, kitchen-order printing, or separate Cashier/Kitchen/Reception screens, install the desktop app:

  1. Log in to the management dashboard in a browser, open Support, and select Download KiotViet Cashier.
  2. Run the downloaded installer (a file such as KiotViet_Thungan.exe on Windows).
  3. Follow the on-screen steps to finish installation; the app launches automatically once done.
  4. Log in using the store name, username, and password created during sign-up.

All computers and POS machines in the same store need to be on one local network (via a router, wired or wireless) so sales data syncs and kitchen tickets print in real time.

ItemMinimumRecommended
OSWindows 7 SP1 or later / macOS 10.10 or laterWindows 10/11
ProcessorIntel Pentium 4 or later (Intel 64-bit for Mac)Core i3 or later
RAM1GB2GB or more
Free storage4GBdepends on data volume

KiotViet sits in the same retail-management category as other platforms listed on this site — see KiotViet, aimed at household businesses and small chains billed per branch — so it's worth comparing your store's actual needs before deciding whether to add the desktop app or just use the browser.

Setting up a receipt printer on a phone

Before anything else, the printer needs a static IP address on the same network as the phone (set this on the router or following the printer's own manual). Then, in the KiotViet management app on a phone:

  1. Open the More menu.
  2. Select Apps & devices.
  3. Select Receipt printer setup.
  4. Turn on Printer setup.
  5. Tap Add new, then tap +.
  6. Choose the correct printer line you're using (for example, a KV804 printer uses the BP-T3 line — the exact line name depends on the model you bought).
  7. Tap Scan IP so the app searches for the printer's IP address on the network.
  8. Select the correct IP address from the results and save.

The printer-setup screen can look slightly different across industry-specific versions of the app (retail, F&B, salon, etc.), but the general path stays the same: go to the devices/printer section in the main menu, then add a new printer by IP or Bluetooth.

Printer not detected or printing errors — check in this order

According to KiotViet's own troubleshooting guide, most printer issues come down to:

  1. A loose USB or network cable — check the physical connection first.
  2. The phone/POS device and printer not being on the same network segment when using LAN — re-check the IP address.
  3. Bluetooth not paired, or Bluetooth turned off on one of the two devices, when using a Bluetooth printer.
  4. Paper loaded the wrong way, or a dirty print head causing faint print — clean the print head with an alcohol-soaked cotton swab.
  5. The connection port changing after the cable is replugged — reopen printer setup and select the correct port again.

If all of the above checks out and printing still fails, it's better to contact KiotViet's technical support than to keep disassembling the hardware yourself.

Setting up a barcode scanner

KiotViet's barcode scanners (both single-line and multi-line models) use plug-and-play USB-HID connections, with no separate driver needed:

  1. Assemble the scanner's stand using the included screws, if it has a detachable stand.
  2. Plug the cable's other end (an RJ-45-style connector) into the bottom of the scanner head, and rest the head on the stand.
  3. Plug the USB end into a USB port on the computer or POS machine.
  4. A beep and a lit scan line mean it's ready — nothing else to configure in the software.
  5. Test it by clicking into the product search field on the sales screen and scanning any barcode.

On a phone, where there's no port for a standalone scanner, KiotViet uses the phone's built-in camera to scan barcodes directly inside the app — no extra hardware needed.

Frequently asked questions

Is installing KiotViet on a computer mandatory?

No. For a typical retail store, you can log in and start selling directly in a browser without installing anything. Only add the desktop app if you need offline operation over a local network or specialized screens like Kitchen and Reception.

What computer specs are needed to install KiotViet Cashier?

According to KiotViet's documentation, the minimum is Windows 7 SP1 or later (or macOS 10.10 or later), 1GB RAM, and about 4GB of free storage; the recommended spec is a Core i3 processor or better with 2GB RAM or more for smoother performance during busy periods.

What do I need to prepare before setting up a KiotViet printer on a phone?

The printer needs a static IP address on the same network segment as the phone running the KiotViet app. Without this, the app won't be able to find the printer when scanning for its IP in device setup.

Does a KiotViet barcode scanner need a driver installed?

No. KiotViet's common barcode scanner models use USB-HID connections, which are recognized immediately when plugged in without any separate driver.

No standalone barcode scanner — how do I scan barcodes on a phone?

The KiotViet mobile app has a built-in camera-scanning feature that replaces a standalone scanner for day-to-day stock entry or sales tasks.

Sources

  1. Ứng dụng cài đặt KiotViet Thu ngân

    Vendor page

  2. Hướng dẫn cài đặt máy in trên app KiotViet Quản lý

    Vendor page

  3. Máy quét mã vạch KiotViet

    Vendor page

  4. Hướng dẫn Cài đặt máy in (KiotViet Salon)

    Vendor page

  5. Hướng dẫn đăng ký tài khoản KiotViet

    Vendor page

  6. Thiết lập cửa hàng KiotViet

    Vendor page

  7. Hướng dẫn khắc phục lỗi máy in hoá đơn không in được

    Vendor page

Products in this guide

Details and how to buy the products this guide mentions.

KiotViet

KiotViet · Sales management software

KiotViet's cloud point-of-sale and store management software for retail, F&B, beauty and hospitality: counter sales, inventory, customers and marketplace selling. Suits household businesses and small chains; priced per branch.

Price not yet verified
Licence
Subscription · Per company (bundle)
Fits company size
Fits 1–50 people
Buy online