Managing sites

On this page

Everything after the site is live is in the same Public site dialog: the address, the audience, the password and the domains. Open it from Public site on the Published Apps row, or from Manage public site in Edit published app.

The person who published the app can change the site, when they also have the Agent module at that facility and can open the hosting Agent. See Access control.

Alpine Lodge Winter Gala on Published Apps, On the internet with a password, and the Public site buttonAlpine Lodge Winter Gala on Published Apps, On the internet with a password, and the Public site button

Figure 1: On the internet with a password. Public site opens the dialog

The live dialog for a password site, with the address, the password and Add domain / external DNSThe live dialog for a password site, with the address, the password and Add domain / external DNS

Figure 2: The live dialog. Leave the password blank to keep it, or add a domain under Add domain / external DNS

The row also has Pause, Edit, Transfer and Unpublish. Transfer changes who the published app belongs to. How that works is on The Published Apps tab.

You can open the running app from Published Apps in the desktop app. The public address is managed in Performance Hub.

Update the app

There is no deploy step. The public address serves the app that is running on the Agent. Change the app, and visitors see the new version.

Every request checks the public-ready rules again. If an update breaks a rule, visitors see "This site isn't available yet" until it is fixed. In the dialog, click Ask the agent to fix these, then Check again. If the app crashes, it restarts on its own.

Backups are how you return the Agent, including the app's files, to an earlier point. See Restore & recovery.

Rename the address

Edit the first part of Web address and save. The 8-character code does not change. You can change the address 5 times a day.

The dialog says "The old address will redirect to the new one for 30 days. Address changes left today: {count}". After you save, it shows "{old-host} redirects here until {date}".

Renaming the web address. The old address redirects for 30 days, and the dialog shows how many changes are left todayRenaming the web address. The old address redirects for 30 days, and the dialog shows how many changes are left today

Figure 3: The old address keeps working, as a redirect, for 30 days

Send people the new address. Bookmarks on the old one keep working for those 30 days, then the old name stops. The rules for the name are on Limits and fair use.

Manage public site in Edit published app opens this same dialog.

Edit published app, with the Public site section set to On the internet and Manage public siteEdit published app, with the Public site section set to On the internet and Manage public site

Figure 4: Manage public site, from the edit dialog. Before the site is on, this button reads Publish to Internet

Change or remove the password

On a live password site the field says "Leave blank to keep the current password". The hint reads "A password is set. Entering a new one signs everyone out, and they need the new password to get back in."

Enter a new password and save to replace it. Everyone who had the old one has to use the new one. Share it only with the people who should see the app.

To remove the password, switch Who can open it to Anyone on the internet and save. The password acknowledgement is replaced by the public one, which you have to tick. See The acknowledgement.

Pause the app

Pause on the row stops the app. The public site is offline until you resume it. The dialog shows an amber banner: "The app is paused, so its public site is offline until you resume it."

The public address with the banner that the app is pausedThe public address with the banner that the app is paused

Figure 5: A paused app. Resume it before the public site will serve again

A visitor who opens the address of a paused app sees the ordinary Site not found page. They do not see a separate offline page.

Site not found, which is also what a visitor sees when the app is pausedSite not found, which is also what a visitor sees when the app is paused

Figure 6: Site not found. A paused app's address shows this page

Resume the app from the same row. The public address, the code, the password and the domains are still there.

Take a site off the internet

Select Only Performance Hub. The button at the bottom becomes the red Take off the internet.

"Not on the internet. People open it from the Performance Hub menu."

Only Performance Hub selected, with Take off the internetOnly Performance Hub selected, with Take off the internet

Figure 7: Take off the internet. The app stays on the Performance Hub menu

The addresses stop serving at once. Visitors see Site not found for a short time, and then the address no longer resolves. The address, the code, the password and the domains are kept, so turning the site on again reuses them.

The owner and the organisation admins are notified by email, in the notification bell and by push.

Unpublish the app

Unpublish removes the app from the Performance Hub menu. Only the person who published it can unpublish it. The app keeps running on the Agent.

If the app has a public site, the warning includes it: "Its public site ({url}) also goes offline, and its custom domains are disconnected so they can be used elsewhere."

Unpublish app, warning that the public site goes offline and its custom domains are disconnectedUnpublish app, warning that the public site goes offline and its custom domains are disconnected

Figure 8: Unpublishing removes the menu entry and takes the public site offline

The app's files and data stay on the Agent. The gateway does not keep a copy of the site. A custom domain that was disconnected can be added to another site.

Removing the Agent takes its published apps, and their public sites, offline as well.

Remove a domain

On the domain card, Remove asks "Remove {domain}? Visitors using it will no longer reach this site."

Confirming removal of www.example.orgConfirming removal of www.example.org

Figure 9: Removing a domain. Visitors using that name stop reaching this site

The domain stays at your registrar. Nameservers are not changed. Adding or removing a domain notifies the owner, and it is recorded in Audit Logs with the other public-site changes. See Custom domains and DNS.