Get Cupola on every device you use.

Cupola is free, needs no account, and talks straight to the services you already run. Pick your device below; the first launch walks you through your services.

Get CupolaSource on GitHub

iPhone and iPad

TestFlight beta, from Apple

Join the beta

Android

APK from GitHub releases

Download the APK

Mac

TestFlight beta, from Apple

Join the betaOr download the signed .dmg, for Apple silicon

Builds for Windows and Linux come with every release, not yet tested on real machines. Or build it from source.

Before you start

  • Your own services. At least one of the seventeen. Cupola does not include any.
  • Each one's address and login. Most use an API key: each service's page says where to find it.
  • A way to reach them. Your home network is enough. Away from home, use your VPN or a reverse proxy.

iPhone and iPad

Cupola is a public beta on TestFlight, Apple's app for testing. Install TestFlight from the App Store, open the invitation link on your iPhone or iPad, and tap Install. Updates arrive on their own.

Prefer to sideload? Download the unsigned .ipa and install it with AltStore, SideStore or Sideloadly. With a free Apple ID the install lasts seven days and has to be refreshed, and the widgets may stay empty. TestFlight is the way we recommend.

Android

Download the .apk and open it. Android asks once to allow installs from your browser. New versions install over the old one. To have them arrive on their own, add github.com/matthw-labs/cupola to Obtainium.

Mac

The Mac app is in the same beta. Open the invitation link on your Mac and install it from TestFlight.

Or skip TestFlight: download the .dmg (Apple silicon) and drag Cupola to Applications. It is signed and notarized by Apple, so it opens like any other app.

Windows and Linux

Every release includes a build for Windows and one for Linux, both x64. On Windows, unzip and run cupola.exe (SmartScreen asks once, as the build is unsigned). On Linux, untar and run cupola; it needs GTK 3 and libsecret. Neither is tested on a real machine yet, so tell us how it goes.

From source

Cupola is a Flutter app. With the Flutter SDK named in pubspec.yaml:

git clone https://github.com/matthw-labs/cupola.git
cd cupola
flutter pub get
flutter run

The first run

  • One service at a time. Add what you run and skip the rest. Test each connection before saving: if it fails, Cupola says why.
  • Home and away. Give a connection a second address for when you are out.
  • A second device in one code. Settings › Security › Set up another device copies everything to a new phone, encrypted, over your Wi-Fi.

Questions

Does Cupola need a server or an account?

No. There is no Cupola account and no Cupola server. The app talks straight to your own services, and their keys and passwords stay on your device, in the Keychain or the Android Keystore.

How do I manage my home server from my phone when I am away?

With the route you already have: a VPN such as WireGuard or Tailscale, or a reverse proxy. Give a connection a second address for when you are out, and Cupola uses whichever one answers.

My services are behind a reverse proxy with a self-signed certificate. Will it work?

Yes. Cupola asks once before trusting a certificate, then pins it to that host. Cloudflare Access tokens, proxy passwords and custom headers work too.

Does it run on Windows and Linux?

Yes, Windows and Linux builds come with every GitHub release, starting with the first. Nobody has tested them on a real machine yet, so a report helps. There is no web version.