Added WG Easy V15 to BigBearCasaOS

BigBearCasaOS BigBearCasaOS Change Log
1

About

The easiest way to run WireGuard VPN + Web-based Admin UI.

Features

  • All-in-one: WireGuard + Web UI.
  • Easy installation, simple to use.
  • List, create, edit, delete, enable & disable clients.
  • Show a client’s QR code.
  • Download a client’s configuration file.
  • Statistics for which clients are connected.
  • Tx/Rx charts for each connected client.
  • Gravatar support.
  • Automatic Light / Dark Mode
  • Multilanguage Support
  • One Time Links
  • Client Expiration
  • Prometheus metrics support
  • IPv6 support
  • CIDR support
  • 2FA support

App Store

Why a new version?

WireGuard Easy v15 - Complete rewrite with new features and improved UI. NOTE: This has breaking changes from v14. If you’re currently using v14, please back up your configuration before migrating.

v15 uses INIT_* variables for unattended setup (only used on first start)

2 Likes
BigBearCommunity November 2025 Updates: New Apps, Videos & More!
2

Is there any detailed instruction? I don’t know the standard login and password. Please help

3

Hello @rider-22 and welcome here!

I do not setup v15, I stay on v14. But according to their docs, try to reset password.

4

I have CasaOS installed.

5

Yes, almost all of us here on forum. CasaOS is just wrapper (web UI fronted) for docker containers.
Docs link which I provided You mention this command to run on Host (Linux, where is Your CasaOS isntalled):

cd /etc/docker/containers/wg-easy
docker compose exec -it wg-easy cli db:admin:reset --password <new_password>

First line in not necessary.
Use just second line under root user permission.

Listing all docker running:
docker ps

Filter wg-easy:
docker ps | grep wg-easy

Maybe there will be name like wg-easy-v15 something like that.

This part of command:

cli db:admin:reset --password <new_password>

Will be executed inside running container, so You will change password. No matter If You run it on CasaOS or whatever else, this command maybe successful for You.

6

Having issues longing in using the default password when installing, not working
manually adding password and user not working

7

Hi @Arty03 and welcome here!

Please provide us more details- commands which You running.

There is no default password. It is generated, or You must reset it.

8

It’s been a long time, but nothing has happened))) and there’s still an error You can’t log in with an insecure connection. Use HTTPS.

9

You can’t log in with an insecure connection. Use HTTPS.

That’s one thing I just got, this didn’t appear at fists, but now I see it
Changing it to HTTPS just doesn’t work

it comes like this as soon as you install it from the casa os app store

image
image649×829 41.5 KB

if its changed to https

big-bear-wg-easy-v15

App may not be available

Please Click hereto open the app. If it does not work, please restart or try again later.

10

Hi.

This is not a bug. Just missing environment variable. Please add ENV:

INSECURE true

(bottom of Your screenshot PORT | Volumes | ENVIRONMENT VARIABLES ← HERE)

Double check You have web UI allowed only from LAN, not from public internet.

11

I’m telling you, I managed to get rid of the https message, I should have specified this argument before installing the application, but I still can’t reset the password)

image
image1858×567 57.3 KB

12

Hi all, I added INSECURE , change my user name change the password to fit 12 characters, delete wg.db in /ZimaOS-HD/AppData/big-bear-wg-easy-v15/data, start and it works :slight_smile:

1 Like
13

Hi @rider-22.

I do not have zimaOS, but try to call docker-compose instead “docker compose”.

See more details:

Your msg from screenshot is related to docker, not wg-easy.

14

what port i need to forward in ordet for this to work?

15

Hi @mihhiv and welcome here!

UDP/51820 is port on Your Host, where docker WG Easy V15 is running and waiting for incoming data. So if You ask for Your router. Port forward this mentioned UDP port from Router to Your Host computer/server.

Example:

internet → router WAN IP UDP/51820

forwarded to 192.168.10.10 (Your server) UDP/51820

16

Hi @mihhiv .

Do You have working setup? Was it success?

17

I keep getting the message ‘can’t access property “authenticated”, session is undefined’ when I try to open the container. I’m using ZimaOS on my home server. In Portainer the container is flagged as being “healthy”. What am I doing wrong?

18

Hi @Qwerty and welcome here! Do You use some kind of Identity provider (Authentik) or proxy (like NPM)? I tried to search “authenticated” on github issues, no success.

In BigBear CasaOS repository is v15.0, but on upstream, there is v15.1 docker available.

So, You can try to mouse over blue button install, “custom install“ pops, You can manually change:

custom_install
custom_install444×205 37.5 KB

wg-easy:15
to
wg-easy:15.1
and try this version. If You were success, please share solution. Thx!

19

Thanks for the reply. I have Duckdns(dynamic IP address from my ISP) installed. I’m also running a VPN on my router, so maybe this is the issue and I have to switch the VPN off to get it all running. I will try the custom install over the weekend.

20

The 15.1 version is not available in the Bigbearcasaos store.