How do I update ProVide Server running on Linux (Docker)?

Updating ProVide Server on Linux is designed to be as simple as possible. In most cases, a single command is all it takes — and your configuration, users, and data are always preserved.

---

Update Using the Setup Script (Recommended) #

To update ProVide to the latest version, navigate to your ProVide directory and re-run the same setup script you used during installation:

bash

cd provide
./provide-setup.sh

The script automatically:

1. Compares the locally installed binary’s timestamp with the latest version on download.provideserver.com
2. Downloads the newer binary only if one is available
3. Rebuilds the Docker container image with the new binary
4. Restarts the container

Note: Active transfers will be handled gracefully. When the container receives a shutdown signal, it issues a SHUTDOWN command to ProVide’s API, giving in-progress transfers up to 90 seconds to complete before the process exits.

---

How Configuration and Data Are Preserved #

All ProVide configuration, user accounts, certificates, and data live in the mounted volume (data/provide) — not inside the container image itself. This means:

• Updating the container image has no effect on your data or settings
• User accounts, group policies, virtual folders, and event rules are all preserved
• Your TLS certificate is not replaced unless you explicitly regenerate it

This architecture makes updates safe to run at any time, even in production.

---

Verify the Update #

After the setup script completes, confirm the container is running correctly:

bash

docker compose ps
docker compose logs -f

The container includes a built-in health check that monitors both the API port (3145) and the HTTPS port (8443). You can also log in to the web administration interface at https://your-server-ip:8443 and confirm the version number in the Details section.

---

Roll Back if Needed #

If you need to roll back after an update, stop the container and replace the ProVide.exe binary in your data volume with the previous version:

bash

docker compose down
# Replace ProVide.exe in ./data/provide with the previous version
docker compose up -d

Tip: Before updating in a production environment, consider copying the data/provide directory as a quick backup:

bash

cp -r ./data/provide ./data/provide-backup-$(date +%Y%m%d)