Skip to content

Latest commit

 

History

History
115 lines (72 loc) · 5.1 KB

INSTALL.md

File metadata and controls

115 lines (72 loc) · 5.1 KB
Raw

Changing your Mozilla Sync installation

Content

  1. Install
    1. App installation
    2. Sync installation on desktop Firefox
    3. Add sync devices
    4. Troubleshooting
  2. Uninstall
  3. Reinstall
  4. Upgrade

Install

App installation

You can either install the stable release version or the development version:

The installation procedure is as follows:

  1. Move the resulting mozilla_sync folder to your ownCloud's apps directory.
  2. Enable it in the web interface's admin panel.
  3. Set an email address for all users that want to use Mozilla Sync. If the user name is already an email address (e.g. external_user app) it will be set automatically when users visit their personal page after installing Mozilla Sync. Note: Email addresses must be unique!

Sync installation on desktop Firefox

IMPORTANT: If you are using Firefox > 29 you need to do this steps befor you can continue with original instructions:

  1. Browse to about:config and press Yes,...

  2. Add a new string named services.sync.tokenServerURI

  3. Fill it with your URL looks like http://YOURCLOUDDOMAIN/remote.php/mozilla_sync/

  4. Add a new string named services.sync.username

  5. Fill it with something other than your Username e.g. blablubb

  6. Restart Firefox and continue with below instructions.

To init the sync of bookmarks, etc. you have to create an account with a desktop installation of Firefox. If you want to sync other devices (e.q. smart phones) do the following installation steps and than pair your device.

  1. Start the sync configuration process

    via the settings > Sync > Set Up Firefox Sync

    or via Tools > Set Up Sync...

  2. A new window opens where you see this:

    You choose "Create a New Account".

  3. In the next form you have to type in your personal data.

    First, you should choose "Use a custom server..." and type in the URL given in the personal settings of your owncloud account (something like http(s)://<owncloud-server>/remote.php/mozilla_sync/). Then you add the email address and password of your owncloud account.

  4. With the button "Sync Options" the dialog switchs to the options.

    Here you choose a name for the device you want to sync and choose which data should be synced.

  5. After finishing the "Account Details" dialog and everything was okay, you see a new tab telling you that the setup is completed and that Firefox is syncing now (which you could see at the progress bar).

Add sync devices

Additional clients can be added manually or with Mozilla's device pairing service. More informations about that you find read at mozilla support: How do I set up Firefox Sync?.

Troubleshooting

Tips and tricks helping you with Firefox sync could be found at mozilla support: Firefox Sync troubleshooting and tips.

Uninstall

To completely uninstall Mozilla Sync, deactivate/uninstall it in your ownCloud's admin panel (attention! this will delete the mozilla_sync directory, so maybe make a backup first).

Then, drop the following tables in your database:

  • oc_mozilla_sync_collections
  • oc_mozilla_sync_users
  • oc_mozilla_sync_wbo

Finally, delete all four entries related to the app from the oc_appconfig table by executing the following SQL statement:

DELETE FROM oc_appconfig WHERE oc_appconfig.appid = 'mozilla_sync' AND oc_appconfig.configkey = 'types';
DELETE FROM oc_appconfig WHERE oc_appconfig.appid = 'core' AND oc_appconfig.configkey = 'remote_mozilla_sync';
DELETE FROM oc_appconfig WHERE oc_appconfig.appid = 'mozilla_sync' AND oc_appconfig.configkey = 'installed_version';
DELETE FROM oc_appconfig WHERE oc_appconfig.appid = 'mozilla_sync' AND oc_appconfig.configkey = 'enabled';

Now you have completely removed Mozilla Sync and are free to do a clean reinstall of the app.

Reinstall

To reinstall the app you can first follow the Uninstall and then the Install sections.

Upgrade

If you want to upgrade the Mozilla Sync app you can just replace the apps/mozilla_sync/ folder with a newer version.