1. Install SwiftPOS
Choose your deployment method. For most users, we recommend Docker deployment for production, or standalone for local testing.
# Docker (recommended for production) git clone https://github.com/nullsam/swiftpos-release.git cd swiftpos-release ./setup.sh # Standalone (SQLite, no database setup needed) DATABASE_URL="file:./swiftpos.db" npm start
See the installation guide for detailed instructions.
2. Setup Wizard
On first launch, SwiftPOS opens the setup wizard where you'll configure:
- Language — English, Arabic, Kurdish (Sorani), Kurdish (Kurmanji)
- Business Details — Store name, address, phone, tax configuration
- Currency — Auto-detected by location, or choose from 30+ currencies
- Admin Account — Create your admin username and password
- License — Enter a license key or start a 30-day free trial
3. Add Products
Navigate to Items in the dashboard sidebar. Add categories first, then create products with variants (size, color, etc.), prices, and stock quantities.
4. Start Selling
Open the POS screen to begin ringing up sales. Search products by name or scan barcodes. Add items to the cart, apply discounts, and process payments.
5. Review Reports
Check the Dashboard for daily summaries, or visit Reports for detailed analytics on sales, products, and employee performance.
Next Steps
- Set up employees with cashier and admin roles
- Configure receipt templates with your store branding
- Add customers to track purchase history
- Set up promotions and discounts