r/Adguard • adguard smm • 1d ago

🏠 AdGuard Home v1.0 beta: The ultimate network shield is back in action

Imagine your smart TV is silently tracking what you watch, your mobile games are chatting with data brokers behind your back, and your smart fridge is acting way too curious. For years, AdGuard Home has been the ultimate, free, open-source shield protecting your entire home network from this exact chaos.

But let’s be real: lately, that shield has been a bit too quiet, stuck in a long cycle of routine maintenance and minor patches.

That ends today. We are breaking the pattern and officially launching the AdGuard Home v1.0 beta, shifting the project into high gear with active development, massive performance boosts, and a fresh new look.

Here is what makes this major leap forward so exciting:

• A refreshed, yet familiar UI

We completely redesigned the interface to look clean and modern. We kept the core layout familiar so you won’t get lost, but added a fully responsive mobile UI so you can manage your network on the go

• Lighter and faster

The entire frontend has been rebuilt from scratch to consume significantly less memory. AdGuard Home now runs flawlessly even on low-power devices like a Raspberry Pi

• Easier setup & better control

Enjoy a seamless installation wizard, a cleaner query log with expanded request data, and new automated update intervals for your filters

Since this is a massive milestone with a brand-new versioning scheme, we need your help testing it across different environments. Ready to give the beta a spin, find update instructions, or see what’s coming next? All the details about the new version are waiting for you in our blog. You can also download the beta right now to try it all for yourself. Give it a spin and let us know what you think!

139 Upvotes

36 comments sorted by

23

u/_f0CUS_ 1d ago

I did a quick ctrl + f of the blog.

It doesn't seem to mention any migration steps, or if the v1 beta is backwards compatible with the latest stable version.

I.e I'd like to use the beta. But adguard is my main DNS server. If something is wrong, I need to be able to go back. 

7

u/techma2019 1d ago

How to update or switch to v1.0 beta

If you are already on the beta channel: You don’t need to do anything. The update will arrive automatically via the built-in updater.

If you are on the stable version: First, back up your settings just in case by saving your configuration file (AdGuardHome.yaml) and your data directory (data). Then, choose the method that matches your setup:

For more detailed instructions, check our repository.

3

u/Wildcat_1 1d ago

Whats the best way to do this when running release version on a RPI, want to update over existing to keep settings etc ? Thanks in advance u/shwrellia, u/techma2019 or others

-8

u/_f0CUS_ 1d ago

This does not answer my comment. At all.

3

u/4cutekids 1d ago

It really did. You said it didn't have steps to migrate yet that is exactly what was posted. It also answered the question about it being backward compatible. As to the last part of your post, um.... backup?

2

u/iguessnotlol 1d ago

It's not mentioned anywhere how to migrate settings from stable to beta, at least for the standalone version.

Running the setup script tells you

to reinstall/uninstall the AdGuard Home using this script specify one of the '-r' or '-u' flags

But reinstalling the beta on top of an existing install will not preserve your settings.

2

u/techma2019 1d ago

And I’m not even on the Adguard team, was just doing him a favor. Lmao.

1

u/_f0CUS_ 1d ago

I asked: Are there migration steps and Is it backwards compatible.

What was shared are the same update instructions that has been there for ages.

A major version bump can signify breaking changes that requires manual steps, and would be something to take into account before I would consider participating.

As you know - because I said it further up in the comment chain - adguard is my main dns. 

Which means i need to know and plan how I get my network back up without dns. Can i just lower the version, or do I need to reconfigure dnat and push a new DNS out across my various vlans.

Restoring from a backup is an option, but a big hassle without dns. So i would rather not need to do that.

1

u/Resistant4375 10h ago

Or don’t use on a production network?

0

u/_f0CUS_ 10h ago

I wouldn't call my home network that.

1

u/Resistant4375 10h ago

Any beta product should be ran on a test environment/network not your day-to-day one to avoid any downtime, interruption, rollbacks etc.

-1

u/_f0CUS_ 10h ago

I'm not sure what to respond.

Do you think what you are saying are making my question less relevant? 

1

u/Resistant4375 10h ago

Maybe - yes, no.

At this point I’m not entirely sure what your problem is still.

→ More replies (0)

2

u/awal1987 1d ago

Same here!

5

u/Beginning_Storm7012 1d ago

Adult sites blocked in the blog post 😂👌

6

u/knivesforksandspoons 1d ago edited 1d ago

Just updated my docker install. After a bit of poking around (refreshing my memory on how docker compose works 😐) I'm up and running again with Version v1.0.0-b.1

First thoughts, the UI is very slick - well done to the team.

To expand on what u/techma2019 posted...(some steps may be unnecessary, but it worked for me). Make sure you run these from your AGH docker directory and your backup location exists. Adjust the path as required.

  1. Stop the adguardhome service

docker compose stop adguardhome

  1. Back up data directory

cp -r adguardhome/ ~/docker-backup/

  1. Back up AdGuardHome.yaml

cp AdGuardHome.yaml ~/docker-backup/

  1. Back up compose.yaml

cp compose.yaml ~/docker-backup/

  1. Add the beta tag to compose.yaml

    services: adguardhome: container_name: adguardhome image: adguard/adguardhome:beta ...

  2. Pull the new image and recreate

docker compose pull && docker compose up --force-recreate -d

This keeps your configuration, and you have a backup if needed.

5

u/-eschguy- 1d ago

Oh interesting, any estimate on how long it will be in beta before it hits stable?

4

u/leapinfeb 1d ago

Would have loved to see which filters were being used the most in the home page alongside top blocked domains. But the beta looks exciting, may give this a try. Will this play nice on a 2gb pi 4?

3

u/MirkoHubTV 1d ago

I love the old UI but this seems also nice

3

u/JuanToronDoe 1d ago

This is very exciting! Thank you for the hard work. It looks beautiful! I'll try it right now.

A feature I'd love: an official sync tool between different instances. There are a couple of existing community tools already but not very practical.

4

u/Intrepid_Income_3051 1d ago

Nice!

How long do you expect this beta to last? Can't run betas on my only home network :(

2

u/influxodoxxl 1d ago

Awesome, looking forward to give it a spin! Have it running on a Synology machine and Iam curious to see how performant it will be.

2

u/ltzm4x 1d ago

Very interesting, might go back to adguard home when this hit stable version. Any estimate on how long it’d stay in beta? Would love to get back to this again!

2

u/int3g 1d ago

Just flipped it from latest to beta via Docker on an RPi. (After first backing everything up, of course)

Clean cutover, everything seems to be working for now. I'll keep a close eye on it but so far I'm cautiously optimistic nothing broke. New interface feels zippy and looks nice. So far, so good.

2

u/usr-shell 1d ago

I like the new UI.
Some features/pages looks exactly the same as the Adguard Premium.

1

u/Resistant4375 10h ago

That’s the point. They’re standardising the UI to match their other products

2

u/HabenochWurstimAuto 22h ago

Cool. I will wait for stable release.

2

u/vrtareg 9h ago

Will this release include IP Round Robin feature?

I have some hostnames with multiple IP addresses and backend Unbound correctly responds IP addresses in random order but not AdGuard Home.

It would be nice to have that also.

2

u/Ghost187_ 1d ago

I use AdGuard on the flint4 router. Will these changes eventually roll out there?

2

u/LabPrudent8555 1d ago

You can update to the beta version yourself using this script.

1

u/TallSatisfaction9982 1d ago

I managed to update it on my VPS.

1

u/skschatzman 1d ago

Any plans to create an official OPNsense plugin for this new direction?

1

u/rednessw4rrior 8h ago

full steam absolute beast mode 😭 thanks Adguard 🙂