Updating

Keeping MyFin and its supporting services up to date ensures you receive the latest features, bug fixes, performance improvements, and security updates.

Updating a Docker Compose deployment is quick and usually only takes a few minutes.

Important

Before performing any update, ensure that all users have logged out of MyFin. Updating while users are actively working may interrupt their session or result in unsaved work being lost.

Step 1 - Create a Backup#

Before updating, always create a backup of your installation.

At a minimum, back up:

• Your companies data

Important

Never perform an update without first creating a backup.

Step 2 - Open a Terminal#

Open a terminal or command prompt on the server.

Change to the directory containing your docker-compose.yml file.

For example:

cd /opt/myfin

Replace /opt/myfin with the location where you installed MyFin.

Step 3 - Download the Latest Images#

Download the latest container images.

docker compose pull

Docker will only download images that have changed.

Step 4 - Restart the Containers#

Stop the existing containers.

docker compose down

Then start the updated containers.

docker compose up -d

Docker Compose will recreate the containers using the newly downloaded images while preserving your existing data.

Tip

You can also perform Steps 3 and 4 using a single command:

docker compose pull && docker compose down && docker compose up -d

Step 5 - Verify the Update#

Open your browser and sign in to MyFin.

Verify that:

• MyFin loads successfully.
• Your data is present.
• Users can log in.
• Reports and documents open correctly.

If everything is working as expected, the update is complete.

Troubleshooting#

The update failed#

If an update does not complete successfully:

1. Check the container logs.

docker compose logs

2. Verify that all containers are running.

docker compose ps

3. If necessary, restore your backup and investigate the issue before attempting the update again.

Recommended Update Schedule#

We recommend checking for updates regularly to ensure your installation remains secure and up to date.

For most installations:

• Check for updates once a month.
• Install security updates as soon as they become available.
• Always create a backup before updating.