Vertex CRM is a high-performance, Salesforce-style customer relationship management platform built for speed, clarity, and multi-organization use. This documentation provides an in-depth guide to installing, configuring, and using the platform in production environments. It is intended for administrators, implementers, and end users who need a comprehensive reference for daily operations, security, and compliance.
The platform supports core CRM objects: Accounts, Contacts, Leads, Opportunities, Activities, Tasks (Validate), Products, Price Books, Cases, Campaigns, and Reports. Role-based access control (RBAC) ensures that users see only the data and features permitted by their role and profile within each organization. Super administrators can manage all organizations; organization administrators can manage users, roles, and permissions within their org.
Vertex CRM is delivered as a single Go binary and uses SQLite by default, making it suitable for lightweight deployments without a separate database server. For production, ensure the host meets the following: a modern 64-bit operating system (Linux, Windows, or macOS), at least 512 MB RAM (1 GB or more recommended for larger datasets), and sufficient disk space for the database and any file uploads (e.g., task attachments). The application listens on a configurable TCP port (default 8080) and serves HTTP; for production, it is recommended to run behind a reverse proxy (e.g., Nginx, Caddy) with TLS termination.
Deployment options include on-premises installation, private cloud, or a hosted instance provided by your organization or a partner. Environment variables control the database connection (e.g., DATABASE_URL), port, secret key for sessions, and optional features such as logo URL and company name. Refer to the project README and your deployment runbook for exact steps. After deployment, the first run performs database migrations and seeds default organizations and demo data if applicable; the default super-admin credentials should be changed immediately in production.
Users authenticate via the login page with a username and password. Sessions are maintained using signed cookies (JWT). Passwords are stored in hashed form and are never transmitted or logged in plain text. After login, users are associated with one or more organizations and, within each organization, with a role and a profile that define their permissions. The organization switcher in the header allows users with access to multiple organizations to switch context; the current organization determines which data (accounts, contacts, leads, etc.) is visible and which actions are allowed.
Super administrators (users with the global admin flag) can access all organizations and all administrative functions. Organization administrators are users whose profile in that org includes "admin" with list and update permissions; they can assign roles and profiles to other users, manage roles, profiles, queues, SLA rules, and other setup items for that org. Regular users see only the sidebar and features permitted by their profile (e.g., accounts list/read/create/update/delete, leads list/read, etc.). The RBAC documentation (e.g., docs/RBAC.md in the deployment) describes the full hierarchy and how to assign roles.
Accounts represent companies or organizations; contacts represent people and can be linked to an account. Both are scoped by organization. Use the Accounts and Contacts list pages to view, search, and manage records. Create and edit forms capture standard fields (name, website, phone, industry, address, etc.). List views support sorting and, where configured, filtering. Export to CSV is available for accounts and contacts for users with list permission.
Leads represent prospects (with status, rating, source, lead score). Leads can be converted or managed through the pipeline. Opportunities represent deals with stages, amount, close date, and probability. The opportunity board provides a visual pipeline view. Stage progression and line items (products) are supported. Forecast and reporting features aggregate opportunity data for management visibility.
Activities include tasks and events (calls, meetings, emails) and can be linked to accounts, contacts, leads, or opportunities. The Validate (Tasks) section provides task tracking with status, progress percentage, and due dates. Task attachments support file uploads (e.g., PNG, JPG, DOC, PDF, XLS, CSV) within configured size limits. Use these for follow-ups, project tracking, and compliance or validation workflows.
Products define the items or services you sell; they can include region and category for multi-region catalogs. Price books group products with optional custom pricing; price book entries link products to a price book with a unit price. Cases are used for support or issue tracking, with status, priority, and optional SLA due dates driven by SLA rules. Queues can be used to assign cases to teams.
Campaigns track marketing initiatives (type, status, budget, cost) and can have campaign members (leads or contacts). Reports allow you to build and run saved report definitions (e.g., accounts by industry, open pipeline, leads by source); results can be viewed in the UI and used for dashboards where configured.
Access Setup via the user menu (username in the header) or the Setup (cog) icon in the sidebar; visibility requires admin list permission. Setup includes: Users (list and assign role/profile per org); Roles and Profiles (create and edit; profiles define object-level permissions); Queues; SLA Rules; Email Templates; Integrations (e.g., Meta Ads, Google Ads, where configured); Organizations (edit name, domain, logo, color); and Audit Log. Only users with admin update permission (or super admin) can assign roles and permissions or create/edit roles and profiles. Ensure at least one organization administrator per org for user management.
Organizations are the top-level tenant. Default seed organizations (e.g., OctaVertex Media, ReNext, Compliance Karo) can be customized or extended. The Compliance Karo seed represents an Indian CA firm offering tax and regulatory compliance, statutory and tax audit, bookkeeping and MIS, payroll, incorporations, and cross-border work for India- and US-based clients. Each organization has its own data; users can be granted access to one or more orgs via user_org_roles. Logo and branding (e.g., primary color) can be set per organization and affect the login and app header when that org is selected.
Vertex CRM can be integrated with external systems via REST APIs and, where enabled, OAuth-based integrations (e.g., Meta, Google). API endpoints typically follow a pattern such as /api/v1/accounts, /api/v1/contacts, etc. Authentication is via session cookie or Authorization: Bearer <token>. Inbound webhooks (e.g., for lead capture from ads or newsletters) may be configured with a shared secret; see the Integrations roadmap and your deployment documentation for payload formats and setup.
When integrating, respect rate limits and use the documented API contracts. Sensitive credentials (e.g., API keys, OAuth secrets) should be stored in environment variables or a secrets manager, not in source code or logs.
Implement TLS in production; use strong secrets for session signing; and restrict database and admin access to authorized personnel. Apply the principle of least privilege: assign users only the roles and permissions they need. Review audit logs periodically for suspicious activity. For data protection (e.g., GDPR, CCPA), ensure lawful basis for processing, document retention, and honor data subject rights (access, correction, deletion, portability) as described in the Privacy Policy. Export and deletion procedures should align with your compliance requirements.
Back up the database file (and any uploaded files) regularly. Test restore procedures. Plan for maintenance windows when applying upgrades. During upgrades, follow the project's release notes and migration guidance. Monitor disk space, response times, and error rates in production. For high availability, consider redundant deployments and load balancing as appropriate for your SLA.
Common issues include login failures (verify credentials and that the account is active), missing sidebar items (check user role and profile permissions for the current org), and slow performance (check database size, indexes, and server resources). Logs and error messages can help diagnose problems. For further assistance, see the Support page and contact your administrator or the team responsible for your Vertex CRM instance.
This documentation is intended for production use. For the latest feature-specific details, refer to the in-app help, release notes, and your deployment's configuration.