Skip to content

# 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`.