Prerequisites
Before you begin, ensure you have the following installed:- Go 1.22 or higher
- Bun 1.0 or higher (for frontend)
- Docker and Docker Compose
- Git for cloning the repository
Quick Setup
Configure Environment Variables
Copy the environment files for both backend and frontend:The default configuration works for local development. You can customize settings later.
Start Docker Containers
Launch the application using Docker Compose:This will start both the backend API and frontend web application.
Seed Sample Data (Optional)
Populate the database with sample data including users, categories, and payment methods:This creates default users:
- Admin:
[email protected]/passwordrahasia - Cashier:
[email protected]/passwordrahasia - Manager:
[email protected]/passwordrahasia
Access the Application
Open your browser and navigate to:
- Frontend: http://localhost:3000
- API Documentation: http://localhost:8080/swagger/index.html
What’s Next?
Now that you have POS Kasir running, explore these guides:Detailed Installation
Learn about manual installation and advanced setup options
Configuration
Configure database, JWT, payment gateway, and cloud storage
First Steps
Learn about user roles, initial setup, and basic operations
API Reference
Explore the complete API documentation
Troubleshooting
Port Already in Use
Port Already in Use
If port 3000 or 8080 is already in use, you can change the ports in your For frontend, modify the Docker configuration or run it outside Docker.
.env file:Database Connection Failed
Database Connection Failed
Ensure Docker containers are running:Check your database configuration in
.env matches your Docker setup.Migration Errors
Migration Errors
If migrations fail, check the migration version:You may need to force a specific version if there are dirty migrations: