Database Setup
PostgreSQL (Recommended for production)
DATABASE_URL=postgresql://user:password@host:5432/swiftpos
PostgreSQL provides the best performance and supports advisory locks for high-concurrency POS operations. The Docker deployment includes PostgreSQL automatically.
SQLite (For development and shared hosting)
DATABASE_URL="file:./swiftpos.db"
SQLite requires no separate database server. The database is stored as a single file. SwiftPOS automatically enables WAL mode and busy timeout for better concurrent performance.
License Activation
SwiftPOS includes a 30-day free trial. To activate a full license:
- Purchase a license key from your reseller or at our website
- Go to Settings > License in the SwiftPOS dashboard
- Enter your license key in the format
SWFT-XXXX-XXXX-XXXX-XXXX - Click Activate
The license server URL must be configured:
LICENSE_API_ENDPOINT=https://license.swiftpos.app
Currency Configuration
Currency is set during the initial setup wizard based on your location. You can change it later:
- Go to Settings > Store
- Find the Currency section
- Search and select your currency, or create a custom entry
SwiftPOS supports 30+ currencies including USD, EUR, GBP, IQD, AED, SAR, TRY, and more.
Receipt Configuration
Customize your receipts at Receipts > Editor:
- Store name, address, and phone number
- Custom header and footer text
- Show/hide tax breakdown
- Barcode on receipt
- Paper width (58mm or 80mm)
Backup & Restore
Available on Pro and Enterprise tiers:
- Go to Settings > Backup
- Click Create Backup to download a JSON backup of all data
- To restore, upload a backup file and confirm