Quick start

This page gets Cloud Viewer showing data in a few minutes, by one of three ways in. At the end you have a populated dashboard, your own Hetzner resources, or a first uptime check that keeps running while your phone is off.

You need the iPhone app, the Android app (it follows the iPhone release) or the web app at app.cloudviewer.app.

Explore with sample data

This needs nothing: no token, no account and no network behind it.

1. Open the iPhone or Android app. On the Dashboard, tap Explore with sample data. The same button is in Settings.

2. Look around. The dashboard ranks the sample servers, with alerts firing on some of them. Resources lists every resource, and Costs shows the month so far. Parts that need a paid plan carry a Pro or Team badge.

In the web app there is nothing to tap: signed out, it shows the same sample data. The sample project is removed in the apps’ Settings like any other project.

Your own read-only token

This is free mode. It needs a Hetzner Cloud project and the iPhone or Android app, but no account.

1. In the Hetzner Console, open your project, go to Security → API tokens and create a token with Read permission. Copy it.

2. In the app, on the Dashboard, tap Add a Hetzner project. In Settings it is Add Hetzner project.

3. Enter a Project name, paste the token into Read-only API token and tap Validate token. The app answers “Token works and is read-only.”

4. Tap Add.

The dashboard now lists the project’s resources, each with its state and what it has cost this month. The token is stored on the device, in the Keychain on iPhone and in the keystore on Android, and never reaches Cloud Viewer’s servers. You can add as many projects as you like.

The web app has no free mode. A browser cannot call the Hetzner API directly, and sending your token through our servers would break the promise that it stays on your device.

A free account and a first uptime check

A free account runs uptime checks from our servers. It stores no Hetzner token.

Create the account at account.cloudviewer.app and confirm your email address. Your first team is created with it. Then:

iPhone

1. In Settings, tap Sign in to Cloud Viewer and sign in. Sign in with Apple, where the app offers it, also creates the account, so you can skip the step above.

2. Open Resources, choose Team, and tap Watch an endpoint, port or certificate from outside your network — add one now.

3. Under What to watch, enter the host of a website you run, without https:// or a path, for example www.example.com. Tap Add.

Android

1. In Settings, tap Sign in and sign in.

2. Open Resources. At the bottom of the list, tap Watch an endpoint, port or certificate from outside your network — add one now.

3. Under What to watch, enter the host of a website you run, without https:// or a path, for example www.example.com. Tap Add.

The web app cannot add checks yet; use Uptime Checks in the portal.

The check appears in Resources under Uptime checks, and the first result arrives within a few minutes. From then on it is checked every 5 minutes from two independent networks, inside and outside Hetzner, also while your phone is off, with 30 days of history. A free account sends no alerts: you see the results when you open the app.

Next steps

Choose your setupWhat a free account, Pro and Team add, and the rules of each.

The dashboardHow the rows are ranked, and what the colours and the strip mean.