TLDR-Go to bottom
Guide: Updating a Crafty Instance
Crafty is a powerful web-based Minecraft server management tool. Keeping it updated ensures you get the latest features, security fixes, and improvements. Follow this guide to update your Crafty installation safely.
⚠️ Important Notes Before Updating
Always back up your data before proceeding.
Stop all running servers and the Crafty instance before updating.
Ensure you have proper permissions to execute commands.
Step 1: Backup Your Crafty Data
Before updating, it's best to create a backup. Run the following commands to back up the necessary files:
tar -czvf crafty_backup.tar.gz /path/to/crafty/
(Replace /path/to/crafty/ with the actual installation path.)
If you're using Docker, back up the container data instead:
docker stop crafty
docker commit crafty crafty_backup
Step 2: Stop Crafty
Ensure Crafty is not running before updating:
systemctl stop crafty
or, if you started it manually:
pkill -f crafty
For Docker users:
docker stop crafty
Step 3: Update Crafty
If you installed Crafty manually, navigate to its directory and update it:
cd /path/to/crafty
git pull
pip install -r requirements.txt
For Docker users, pull the latest image:
docker pull registry.gitlab.com/crafty-controller/crafty-4
Then restart the container:
docker-compose down
docker-compose up -d
Step 4: Start Crafty Again
Once the update is complete, restart Crafty:
systemctl start crafty
Or manually:
cd /path/to/crafty
python3 crafty.py
For Docker:
docker start crafty
Step 5: Verify the Update
After starting Crafty, open your web browser and access the panel. Check the version in the Crafty dashboard to ensure it's updated.
If any issues arise, review the logs:
cat /path/to/crafty/logs/crafty.log
For Docker:
docker logs crafty
✅ Done!
Your Crafty instance is now updated and ready to use. If you encounter issues, consult the official Crafty documentation or seek help in the community forums.
To update crafty without losing data:
docker stop crafty_container
docker rm crafty_container
docker pull registry.gitlab.com/crafty-controller/crafty-4:latest
docker-compose up -d && docker-compose logs -f
This works if you used docker compose to initially setup crafty, otherwise refer to the tutorial linked in useful tutorials.