Iceblock documentation

Getting started

Iceblock runs on Android phones and tablets and on Linux computers. Windows is on the way.

Install it

  • Android. Iceblock is on Google Play, in closed testing: join the test with the Google account your phone uses, then install it from the Play Store, which brings each update. Without Google Play, install Obtainium, a free app that installs apps from their own sites and tells you when there’s an update. Then, on your phone, tap Add to Obtainium on the home page, under Install Iceblock, which opens Obtainium with Iceblock set up, and tap Install. Or, in Obtainium, tap Add app, enter https://git.tricauda.com/iceblock/releases, set Override source to Forgejo (Codeberg), tap +, then Install.
  • Ubuntu or Debian. Add Iceblock’s package repository, and apt install iceblock-gui installs it and brings each update. The commands are on the home page, under Install Iceblock.
  • A server, or Linux without a desktop. The iceblock package alone: the command line, with nothing graphical. See A server.
  • Any other Linux. Download iceblock-linux-x64.tar.gz from the latest release, unpack it where you’d like it to live, and run install.sh in it.

On a computer, Iceblock starts whenever you log in and keeps running in the background, with an icon in the top bar. Closing its window doesn’t stop it.

Your network

The first time Iceblock opens, it makes your network: your devices, and the files they keep together. It asks your name, which is what people you share with see.

A network with one device works, but your files are only safe once they’re on more than one. Add your other devices next. A computer that’s always on is the best second device: it keeps copies while your phone is off, and makes the thumbnails for your photos.