New Release: SAFE Authenticator v0.2.0 & SAFE Mobile browser v0.3.0

It has been several months since we released any updates for the mobile Authenticator or Browser. A lot has changed in the intervening time, with the most obvious change being the decommissioning of the Alpha II network which the mobile Authenticator and Browser were specifically tailored to work with. This signalled our main focus to switch towards Perpetual Web (pWeb) and so, for the last couple of months, we’ve been working to deliver you the Pweb experience on your mobile devices. This release is full of new features and has us excited :tada:

For this release, we aimed to provide an integrated UI/UX flow between multiple single vault networks and mobile devices. This included all new .Net API packages, updating the Authenticator app to help you choose and easily switch between different vaults you may wish to connect to, and enabling you to browse the content on each vault, including being able to flick through the different versions of any site - pWeb has gone mobile :wink:

What’s new in the Authenticator App v0.2.0

You will notice several changes to the Authenticator app if you had been a user of the previous version. The general login and create account functionality will appear to operate in a similar way to before, but there’s been a vast rewrite under the hood to make this compatible with pWeb. Here’s a few of the major UI changes you will see.

New Choose a Vault page
Using the settings button on the LoginPage a user can add/remove/select a vault from the list. It may be a shared vault, or a vault running in your local network. You simply need a copy of the vault_connection_info.config for the vault you want to connect to on your mobile device, add it to the Authenticator app through the Choose a Vault page, and give it a name to identify it. You then select which vault from your list you want to connect to at this time and return to the login page to log in to that vault.

New Test SAFE coin permissions
Those of you familiar with the safe-cli have probably been using test coins for a while now through the CLI and associated APIs. So, we have updated the app to show the requested test coin permissions, with the ability to check an app’s information page on the authenticator to see if it has permissions to work with test coins.
As far as we are aware there are no apps currently developed that use these new test coin permissions, but this puts support for them in place for when that time comes.

UI Updated to use Material design controls
These changes don’t bring any new functionality to the app, they do however make it smoother, and generally provide a much nicer user experience.

Experience pWeb with Mobile Browser v0.3.0

This brings the mobile Browser in line with the desktop Browser in supporting the latest vault developments. The previous mobile Authenticator and Browser were built to work with the Alpha II network, which is now obsolete and decommissioned.

All new pWeb support
What is the pWeb? If you missed our original vision of the Permanent Web, or just need a reminder, then we recommend you watch this video which we released in July 2019.
Look out for the page version buttons on any pWeb site you visit - the future of history is there for you to see!

Check the FilesContainer content
In previous versions of the browser, if a URL didn’t point to a file or the target location didn’t have an index.html file, we would show an error page. To provide correct information, with the help of improved APIs where we use FilesContainer to upload the files on the network, we now show the list of the files from the files container. Note that at this stage you cannot click to download the files from the mobile Browser - something we’ll look at implementing in a future iteration.

Download and Install

Note: We use Azure App Center to distribute iOS builds. If you haven’t already registered with us and been added to our App Center test groups for the previous mobile Authenticator and Browser version testing on iOS, please register here. We will then add your email address into our testing groups, which will notify you via an invite email giving you the option to register your iOS device(s), then download and install the apps.

SAFE Authenticator

Platform OS & Architecture Download Link QR Code
Android 5.0+ (armeabi-v7a, x86_64) GitHub, AppCenter Android-QR
iOS iOS 11+ (ARM64, x64) AppCenter iOS-QR

SAFE Browser

Platform OS & Architecture Download Link QR Code
Android 5.1+ (armeabi-v7a, x86_64) GitHub, AppCenter Android-QR
iOS iOS 11+ (ARM64, x64) AppCenter iOS-QR

Note: If a Blocked by Play Protect pops up during installation, just click install anyway


  • To connect the authenticator to a vault you will require a copy of the vault_connection_info.config file for the vault(s) you want to connect to, on your mobile device.
    • For the Shared Vault you can download the config file here
    • For your local vault see the original Vault Phase 1 release post for details on where the vault_connection_info.config file will be stored on your OS.
  • To authenticate the SAFE Mobile Browser you require the SAFE Authenticator for mobile
    • See the table above for links to install.

    • For iOS, when you register with AppCenter for the iOS browser app, you will also be registered to receive the SAFE Authenticator for Mobile app. You will then be able to download this app via AppCenter and authenticate onto a vault.

Known Issues

We would like to make you aware of a couple of known issues with these releases:

  1. Unable to connect to vaults on Android API versions less than 26.
    We intend to support access on Android from v5.0 API 21 on the SAFE Authenticator, and v5.1 API 22 on the SAFE Browser, however we are aware of an issue on Android v7.1.2 (API 25) and below, where the new SAFE Authenticator is unable to connect to a vault. See here to track logged issue.
  2. Authenticating the browser via Android switches the Authenticator back to its login screen.
    Although the SAFE Authenticator is logged in, when a user clicks to authenticate the SAFE Browser they are returned to the login page of the SAFE Authenticator. Clicking to allow the Browser request still works, the user does not need to log in again, but this may be confusing. See here to track logged issue.

How to connect your mobile device to a vault

If you are connecting to the Shared Vault then setup steps are as follows:

  1. Download to your mobile device a copy of the Shared Vault vault_connection_info.config file from here.
  2. Open the new SAFE Authenticator, click into settings and click to add a new vault. Browse to and select your downloaded config file, name it and you are good to log in with your Shared Vault login details, or create a new Shared Vault account if required.

If you would like to connect to a local vault on your home network, which is running on a machine which does not have an externally exposed IP, then there are a couple of extra steps.

  1. First, you should note the local IP (e.g. 192.168.xx.xx) of the machine you will be running your vault on.
  2. Launch your local vault with a command which specifies that IP so it is explicitly added to the config file that it produces, i.e. safe_vault --ip 192.168.xx.xx.
  3. Copy the newly generated vault_connection_info.config file to your mobile device.
  4. Open the new SAFE Authenticator, click into settings and click to add a new vault. Browse to and select your local vault config file, name it and you are good to log in with your local vault login details, or create a new account if required.

See the original Vault Phase 1 release post for more information on running, connecting to and using vaults.

Contribute or give feedback

As an open-source project, we’re excited to accept contributions to the code from outside of our immediate team and we aim to make that as easy as possible. Details of how to contribute are all over on GitHub, or if you prefer, just add any feedback to this post and our team will pick it up.



Happy Hump day!!!
This is awesome :heart_eyes:


This looks fabulous, thank you everyone. I haven’t tried it yet but there’s something I want to suggest for mobile and desktop browser with pWeb…

I think we need different version buttons because < > are very like the browser back and forward buttons and will probably confuse the hell out of people. I know they are nice in other ways, which is no doubt why they are already in use, so I would like us to scratch or heads for ideas on alternatives.

  • Up/Down buttons?
  • +v and -v
  • Possibly adding a version numeral between them are first thoughts.
  • Are there any comparable version controls we can consider?

This seems to be good, perhaps not numbers but how far back in version. So current then current-1 type thing?


Hey @happybeing, that’s for the initial feedback. We actually have two sets of the back and forward button. One pair is in the bottom toolbar to move through the navigation history. and another pair is in the address bar which in only visible on the valid pages (when the web page is available). The buttons gets enabled/disabled based on current page version and maximum possible version.


In the images it’s not showing any number cause that’s the latest version otherwise if we move backward/forward through the version history, it’ll append the current page version in the url.

Initially I planned to show a current version label with the option to choose any random previous version which I didn’t implement to keep it simple. That’s something for the future versions.


I wonder when we do that we do it with negative numbers? So -1 means 1 back etc. ?

1 Like

I am not sure if I’m following here but for example, if a webpage say safe://welcome has 7 version then the browser will show in following order:

  • safe://welcome when first loaded (as we always show the latest version), on back/forward
  • safe://welcome?v=5 to safe://welcome?v=0

Thanks @ravinderjangra. I understand those points. The problem is that people are already conditioned to see those shapes as browser navigation so I think we should try something different if possible.

I think a numeral helps, but I don’t think it will be enough, so I think something other than < and > should be sought. This applies equally to the desktop browser.


Food for thought for @JimCollinson :wink:



  • +v and -v

Having no time and with a mind that it’s always good to jump in without reading…

Download install works well on Andriod. :+1:

Thrown slightly by above suggesting AppCenter for Android Authenticator but needing github … and knowing to expand the assets downdown… browser was much easier for that option on AppCenter.

Will have closer look later :grinning:


Aha well spotted, have updated that pre-req section to be a bit less confusing.

1 Like

PROBLEM: I’m on Android tablet and this isn’t working for me. I think because it isn’t finding a vault connection file. I first uninstalled the previous Safe apps, then used the APK files to install.

  • I can’t browse without authenticating, and can’t authenticate either. When I go to select the vault in authenticator it says no vault connection file was found.

@happybeing Are you trying to connect to the shared vault? Did you successfully download the config for it onto your tablet? (link in OP)

If so, when you are in the add a vault page are you able to click the + icon and find that config file?

Don’t these come with a vault config file? Sorry, I missed that.

1 Like

We haven’t included by default. We left open so people could add their own depending on what they wanted to connect to.
It’s not a bad idea to auto package the shared vault config with the app though, maybe a little complication because the config file could update at any time if we restart for any number of reasons. One to think about @ravinderjangra


Error message perhaps needs to be SAFE context specific.

I have internet but not SAFE internet…

Message is atm

No internet connection
Please connect to the internet.

Nice impression on the design aspects… looks good.


I added the config file and selected it (gave it the name ‘Shared vault’) but it still says it can’t find the vault config file. It takes me to the Choose a vault page where I have just one listed: ‘Shared vault’.

  • It’s not obvious how to choose it.

  • So I clicked on ‘Shared vault’ to choose, and it gives me a popup with the option to cancel or delete. So maybe I haven’t chosen, I’m not sure?

  • the popup to delete is misleading as it has the title ‘Choose a vault’. Better ‘Delete selected vault?’

An alternative UI would be check boxes to select, then a button for the action: with a button for Select Config, and one for Delete Config (maybe also rename).

I think it is fine as is for now, but for idiots like me who don’t read the whole post it might be worth making it clear nearer the download links that you also need to grab the config file.


Asking me to update my ip, are we still doing that?