Appe - Setup
Setting up the Appe App is quick and effortless! Just follow the steps below to connect your Frappe/ERPNext server with the Appe Mobile Application.
1. π Prerequisites
Before you begin, make sure you have the following ready:
ERPNext/Frappe Instance
- Your ERPNext site should be accessible via public IP or domain name (e.g.,
https://erp.yourcompany.com). - The site must be live on the internet (not just localhost) if you want to connect from outside.
- Your ERPNext site should be accessible via public IP or domain name (e.g.,
Frappe User Account
- You must have a valid Frappe User created.
- User should be linked with an Employee OR Appe Employee.
Login Credentials
- Keep your domain/IP, username, and password ready.
Example:
- Domain/IP β
https://erp.yourcompany.com - Username β
employee@company.com - Password β
********
- Domain/IP β
2. π Domain Registration
To enable seamless communication between ERPNext/Frappe and the Appe Mobile Application, you need to register your ERPNext site domain or public IP.
- Open the Domain Registration Form provided within the Appe setup.
Enter your ERPNext site details:
- Domain/IP (example:
https://erp.mycompany.com) - Site Name (optional, for your reference)
- Domain/IP (example:
- Save and submit the form.
π Once registered, Appe will recognize your ERPNext instance for login and data sync.
3. π² Logging into the Mobile App
After completing domain registration and prerequisites, follow these steps:
- Open the Appe Mobile App on your Android device.
On the login screen, enter:
- Domain/IP β Your ERPNext domain (e.g.,
https://erp.yourcompany.com) - Username β ERPNext login ID
- Password β ERPNext account password
- Domain/IP β Your ERPNext domain (e.g.,
- Tap on Login.
β If your domain and credentials are correct, you will be logged in successfully.
4. π Post-Login Setup
Once logged in, you can:
- Access ERPNext Doctypes (Sales Order, Purchase Order, Employee, etc.) directly on mobile.
- Use any custom Frappe app features available in your ERPNext site.
- Receive real-time notifications and manage approvals.
- Use Face Recognition Services if enabled in your system.
5. β οΈ Troubleshooting
- Invalid Domain/IP Error β Check if your ERPNext site is publicly accessible. If using HTTPS, ensure SSL is properly configured.
- Invalid Credentials β Make sure the ERPNext User is active and linked to an Employee record.
- App Not Syncing β Restart your bench (
bench restart) and confirm API access is enabled.
6. π― Summary
- Register your ERPNext Domain/IP using the provided form.
- Ensure you have a valid User linked with an Employee.
- Login from the Appe mobile app with your Domain/IP, Username, Password.
- Start managing your ERPNext/Frappe system anytime, anywhere.