ACUMATICA

Acumatica Version Control

February 21, 2024 12 min read

Introduction

Managing Acumatica customizations with version control ensures traceability, collaboration, and safe deployments. This guide covers best practices.

Customization Projects

Acumatica stores customizations in projects:

  • Customization Project - Contains all customizations
  • Files - ASPX, code files, images
  • Scripts - Database scripts, setup
  • Publishing - Track version history

Git Integration

// Recommended .gitignore for Acumatica:

/App_Data/*
!/App_Data/Include/
/Site/
/App_Online/
/temp/
*.user
*.suo

// Track:
/Site/ASPX/**/*.aspx
/Customization/
/Scripts/
/App_Data/Include/

Best Practices

  • Separate Projects - Use different projects for different modules
  • Version Tags - Tag releases in Git
  • Document Changes - Include change logs
  • Test First - Always test in dev before prod
  • Backup Before - Backup before publishing

Summary

Version control for Acumatica customizations improves collaboration and reduces risk. Use Git to track changes and manage deployments.

For more guides, see Customization Tutorial.