![\"\"](\"https:\/\/resizemyimg.com\/blog\/wp-content\/uploads\/2025\/04\/empty-hallway-with-storage-units-server-backup-database-storage-data-protection.jpg\"){kind=spacer}
\nSelf-hosting Invoice Ninja v5 offers businesses full control over their data and operations, but with that control comes significant responsibility. One of the most critical tasks for any self-hosted environment is implementing a reliable, automated backup system. Losing client information, invoices, and payments due to accidental deletions, hardware failures, or cyber attacks can have severe repercussions.<\/p>\n
This guide will walk you through how to script automatic backups for your self-hosted Invoice Ninja v5 installation, ensuring data integrity and peace of mind.<\/p>\n
Invoice Ninja stores sensitive client data and financial records, making it a prime target for malware or database corruption. Manual backups are prone to human error and inconsistency. Automating this process removes reliance on memory and simplifies disaster recovery.<\/p>\n\n
A comprehensive backup strategy should include:<\/p>\n
Here\u2019s a detailed breakdown of how you can script backups on a Linux server hosting Invoice Ninja v5.<\/p>\n
\/var\/www\/invoiceninja<\/code> or similar.<\/li>\n- Database credentials<\/em>: Stored in the
.env<\/code> file in the root of the Invoice Ninja directory.<\/li>\n<\/ul>\n2. Create the Backup Script<\/h3>\n
You can use a Bash script to handle copying files and dumping the database contents:<\/p>\n
#!\/bin\/bash\nTIMESTAMP=$(date +\"%F\")\nBACKUP_DIR=\"\/opt\/backups\/invoiceninja\/$TIMESTAMP\"\nAPP_DIR=\"\/var\/www\/invoiceninja\"\nDB_NAME=\"ninja\"\nDB_USER=\"ninja_user\"\nDB_PASS=\"your_db_password\"\n\nmkdir -p $BACKUP_DIR\n\n# Backup Invoice Ninja files\ncp -r $APP_DIR $BACKUP_DIR\/app\n\n# Dump the database\nmysqldump -u $DB_USER -p$DB_PASS $DB_NAME > $BACKUP_DIR\/ninja.sql\n\n# Optional: compress the backup folder\ntar -czf \/opt\/backups\/invoiceninja_$TIMESTAMP.tar.gz -C \/opt\/backups\/invoiceninja $TIMESTAMP\n\n# Cleanup old backups (older than 7 days)\nfind \/opt\/backups\/ -name \"*.tar.gz\" -type f -mtime +7 -delete\n<\/code><\/pre>\nNote:<\/strong> Replace credentials and file paths with values that match your setup. Ensure the script is executable and protect it with limited permissions to avoid unauthorized access.<\/p>\n3. Configure Cron for Automation<\/h3>\n
To automate the backup process, schedule the script using cron<\/code>:<\/p>\ncrontab -e<\/code><\/pre>\nAdd the following line to run the backup daily at 2 AM:<\/p>\n
0 2 * * * \/opt\/scripts\/backup_invoiceninja.sh >> \/var\/log\/invoiceninja_backup.log 2>&1<\/code><\/pre>\nThis ensures daily, unattended backups that are logged for audit and troubleshooting.<\/p>\n
Extra Considerations<\/h2>\n1. Encrypt Your Backups<\/strong><\/h3>\nFor added security, especially when storing backups off-site or in cloud storage, use tools like gpg<\/code> or openssl<\/code> to encrypt the backup files.<\/p>\n2. Remote and Offsite Storage<\/strong><\/h3>\n
![\"\"](\"https:\/\/resizemyimg.com\/blog\/wp-content\/uploads\/2025\/09\/a-close-up-of-a-server-room-cloud-backup-storage-data-replication-secure-server-racks.jpg\")
\n