Install on your phone

You can put the panel on your home screen, like an app from the App Store or Google Play. You get its own icon, it opens without an address bar, and you can receive notifications when something happens to your servers or your account.

There is nothing to install and no app store involved: the panel you already use is the app.

Android (Chrome, Edge, Samsung Internet)

1. Open the panel in your browser and sign in.
2. Your browser offers to install it — usually as a bar along the bottom, or under ⋮ → Install app.
3. Confirm. The icon then sits among your other apps.

From then on, links to the panel open in the app rather than in a browser tab.

iPhone and iPad (iOS 16.4 or newer)

1. Open the panel in Safari and sign in.
2. Tap Share (the square with the arrow pointing up).
3. Choose Add to Home Screen and tap Add.

Since iOS 16.4 this also works from Chrome, Edge and Firefox on your iPhone. The steps are the same: Share → Add to Home Screen.

Two things that are different on iOS

You have to sign in once more. Apple gives an app on your home screen its own walled-off storage, cookies included. The app therefore knows nothing about the session you had in Safari. It is a one-off: after that you stay signed in, and for longer than in Safari itself — the storage limit Safari applies to websites does not apply to an installed app.

Notifications only work once it is installed. In Safari itself the button does not exist; that is Apple's decision, not ours. Put the panel on your home screen first, open it from there, and turn notifications on then.

Turning notifications on

1. Open the panel (on an iPhone: from your home screen).
2. Tap the bell at the top right, then Preferences. You can also go to Notifications in the menu.
3. Under the five categories there is Notifications on this device. Switch it on.
4. Your phone asks for permission. Grant it.
5. Tap Send a test notification to check that one arrives.

You only receive the categories that are switched on above. Switch Servers off and no push about servers arrives either — the switches govern the bell, the on-screen notification and your phone alike.

Per device. Your phone and your laptop are two separate registrations. Switching it off on your phone leaves your laptop receiving notifications, and the other way round.

Tapped Don't allow by accident? Then the panel cannot ask again — no website may. Allow notifications for this site again in your browser's settings (or, on an iPhone, in Settings → Notifications → CoreCP) and try once more.

No connection

An administration panel has nothing useful to show without a connection to the server: everything you see is the state at this moment, and showing it from an old copy would be worse than showing nothing. Without a network you therefore get one page — offline, reconnecting — and everything resumes the moment you are connected again. Nothing is lost.

For the same reason the panel does not keep working "in the background" once you close it: background sync for web apps does not exist on the iPhone, and we do not pretend otherwise.

A new version

When a new version is ready you see A new version is available with a Refresh button. The panel never refreshes itself: you may be halfway through a form or have a terminal session open. Press Refresh whenever it suits you; whatever you have open stays exactly as it is until then.

If your panel belongs to your hosting company — the technical part

The panel installs under the name and icon of the address you open it on: at your reseller it is their app, not CoreCP. That comes from the manifest the server serves per hostname, and you can read it back:

curl -s https://panel1.corecp.dev/manifest.webmanifest | jq '{name, short_name, start_url, display}'

{
  "name": "CoreCP",
  "short_name": "CoreCP",
  "start_url": "/",
  "display": "standalone"
}

If the wrong name or icon appears there, that is a branding setting at your hosting company, not a fault on your phone.

If your panel belongs to your hosting company

If the panel runs on your hosting company's address, you install their app: their name under the icon, their logo, their colour. It is the same application at a different address, and the two are entirely separate — their own sign-in, their own notifications, their own icon.