Product

Product Features How to Compare Docs Screenshots Why

Start here

Getting started Download Guides Frequently asked questions

More

Security Support Roadmap About

Applying changes

7 answers

Making things live, and putting them back.

Looking for something specific

The searchable index covers all 326 answers at once and filters as you type.

281 Make my changes live

Press Apply config. Everything you have saved is built into a full configuration, staged on every node, tested with each node's own nginx binary, and only then swapped in.

If any node refuses, every node keeps what it had and you are told exactly what was wrong.

applygo livedeploysave vs apply
282 I changed something and nothing happened

You saved it and did not apply it. Saving changes nothing for your visitors, which is the point: you can save as often as you like and apply when you are ready. The banner at the top of every page says when something is saved and not live.

not workingno changesavedapply
283 See what is about to change before I apply

The Changes page shows what is saved and not yet live, and what it changes. Read it before applying, particularly if somebody else has been working on the same thing, because you are about to make their changes live along with your own.

previewdiffchanges pagepending
284 Undo a change I just made

Changes page, look at the history, and put an earlier version back. It applies the same way any other change is applied: built, checked, staged on every node, tested, then swapped in. So a rollback cannot break the fleet either.

undorollbackrevertprevious version
285 Why did my apply get a warning?

The most common one is a pool with no healthy servers in it, which means the site would serve errors. A warning is not a refusal: sometimes serving an error page from a pool you are about to fill is exactly what you meant to do.

warningno healthyconfirm
286 What if a node was switched off during an apply?

It does not block the change. The change goes into that node's queue and is replayed when it comes back, so it catches up rather than quietly drifting.

offline nodequeuecatch updrift
287 Does applying drop connections?

No. An nginx reload is graceful: the master starts new workers with the new config, hands them the new connections, and lets the old workers finish what they were doing before they stop. Nobody is disconnected and no request is dropped.

The one thing to know is that very long lived connections, such as WebSockets, keep old workers around until they close.

reloadgracefuldowntimewebsockets

Two fresh servers is all it takes

Ubuntu 22.04 or newer, root access, and about twenty minutes. The installer does the rest and it is safe to run twice.