Migrate from v14 to v15

This guide will help you migrate from v14 to version v15 of wg-easy.

Changes

• This is a complete rewrite of the wg-easy project, therefore the configuration files and the way you interact with the project have changed.
• If you use armv6 or armv7, you unfortunately won't be able to migrate to v15.
• If you are connecting to the Web UI via HTTP, you need to set the INSECURE environment variable to true in the new container.

Migration

Backup

Before you start the migration, make sure to back up your existing configuration files.

Go into the Web UI and click the Backup button, this should download a wg0.json file.

Or download the wg0.json file from your container volume to your pc.

You will need this file for the migration

You will also need to back up the old environment variables you set for the container, as they will not be automatically migrated.

Remove old container

1. Stop the running container

If you are using docker run

docker stop wg-easy

If you are using docker compose

docker compose down

Start new container

Follow the instructions in the Getting Started or Basic Installation guide to start the new container.

In the setup wizard, select that you already have a configuration file and upload the wg0.json file you downloaded in the backup step.

Environment Variables

v15 does not use the same environment variables as v14, most of them have been moved to the Admin Panel in the Web UI.

Done

You have now successfully migrated to v15 of wg-easy.