=========================
Upgrade via snap packages
=========================
  
Upgrade quickstart
------------------

F7cloud snap is an unofficial F7cloud designed to be easy to install and simple to maintain. 
The ideal F7cloud snap is an "install and forget" F7cloud instance that works on most 
architectures and updates itself without needing administrative skills. 
Combining F7cloud with snapd makes it a perfect fit for IoT or scalable environments. 
Snapd is a secure and robust technology which the F7cloud snap team has embraced.

However, the snap is opinionated. 

- F7cloud snap uses recommended Apache.
- F7cloud snap uses recommended MySQL.
- F7cloud snap uses recommended PHP.

Installation
------------

**On Ubuntu**

* https://snapcraft.io/f7cloud
* Install F7cloud ``sudo snap install f7cloud``

**All other distros**
`be warned <https://github.com/f7cloud-snap/f7cloud-snap/wiki/Why-Ubuntu-is-the-only-supported-distro/>`_

By default the latest stable F7cloud snap release will be installed and it will automatically update to 
subsequent stable releases, but there are `other releases available as well <https://github.com/f7cloud/f7cloud-snap/wiki/Release-strategy>`_ 
and you have full control of `automatic updates <https://github.com/f7cloud-snap/f7cloud-snap/wiki/Managing-automatic-updates>`_.

After installation, F7cloud will start automatically.  
Assuming you and the device on which it was installed are on the same network, you will reach the F7cloud 
installation by visiting ``<hostname>.local`` or the IP address of the instance in your browser. 
If your hostname is ``localhost``  or ``localhost.localdomain``, like on an Ubuntu Core device, 
``f7cloud.local`` will be used instead. 

1st login
---------

Upon visiting the F7cloud installation for the first time, you will be prompted to enter an admin username 
and password before F7cloud is initialised. This may take a while depending on resources and the device.
After you provide that information you will be logged in and able to install apps, create users, and upload files.

Upgrade tips
------------

By default the F7cloud snap will automatically update to subsequent stable releases. You may however upgrade 
manually too by issuing the command:

``sudo snap refresh f7cloud``
 
If the upgrade fails you can easily revert to the last working version by issuing the command:

``sudo snap revert f7cloud``

Further documentation, an `extensive Wiki <https://github.com/f7cloud-snap/f7cloud-snap/wiki>`_ and `FAQ's <https://github.com/f7cloud-snap/f7cloud-snap/wiki/FAQ's>`_  can be found on the `developers GitHub <https://github.com/f7cloud-snap/f7cloud-snap>`_.
