Support

Documentation

Basic Operations

The Basic Operations group contains the most common functions you will need on your day to day Akeeba Backup use. In fact, you will only use the other features occasionally, mostly when you create a backup profile or want to update it after doing significant changes to your site.

Profiles Management

Profiles Management page

The Profiles Management page is the central place from where you can define and manage backup profiles. Think of each backup profile as a named group of Akeeba Backup configuration settings and filters. Each one uniquely and completely defines the way Akeeba Backup will perform its backup process.

The main page consists of a list of all backup profiles. On the left hand column there is a check box allowing the selection of a backup profile so that one of the toolbar operations can be applied. The other column displays the description of the backup profile. Clicking on it leads you to the editor page, where you can change this description.

On the page's toolbar you can find the operations buttons:

New

Creates a new, empty profile. Clicking on this button will lead you to the editor page, where you can define the name of the new profile, or cancel the operation if you've changed your mind.

Copy

Creates a prostine copy of the selected backup profile. The copy will have the same name and include all of the configuration options and filter settings of the original.

Enable one click-backup icon

Available under the Actions menu button.

Enables the one click backup feature for this backup profile. An icon will be shown in the Control Panel page of the component for this profile. Clicking on it will immediately start a new backup using this profile, without further user interaction.

Disable one click-backup icon

Available under the Actions menu button.

Disables the one click backup feature for this backup profile.

Reset

Available under the Actions menu button.

Resets the configuration and filter settings of the selected backup profiles to their default values. Use this if you feel like you've messed up your backup profile so bad you'd rather start over.

Delete

Available under the Actions menu button.

Permanently removes the selected backup profiles. All associated configuration options and filter settings are removed as well. This is an irreversible operation; once a profile is deleted, it's gone forever.

Please note that you cannot delete the default backup profile (profile ID 1). Instead, use the Reset action on it to restore it to the factory default settings and start over.

Import

Opens a modal dialog with the profile import feature. Use it to import a backup profile JSON file you had exported using the Export button described below.

We strongly advise you to review your settings after importing a profile. If the profile comes from another site you may have used an absolute path or overridden the database connection information. In this case you will have to change those settings to reflect the current site's configuration.

When you create a new profile or copy an existing profile, the newly generated profile becomes current. This means that you can work on your new profile as soon as you're finished creating it, without the need to manually make it current from the Control Panel page.

To the left of each profile's name you will find two buttons:

Configure...

Clicking this button makes that profile current and opens the Configuration page. This is equivalent to going back to the Control Panel, selecting that profile in the list, waiting for the page to reload and clicking on Configuration. We figured that having to click to just one button is much faster – and simpler!

Export

You can export a profile in JSON format. Clicking this button will ask you to download a file with all of the profile settings. You will be able to import that file on the same or a different site using the Import feature further down the page.

Please note that the file you are downloading contains all of the configuration information UNENCRYPTED. We strongly advise you to only use this feature when connected to your site over HTTPS. We also strongly advise against storing exported profile files in media which could reasonably be lost (e.g. USB keys) or cloud services without file encryption that you manage yourself. Whenever possible, encrypt the exported backup profiles e.g. with GPG or even in a password-protected ZIP file before storing them.

Each row displays the profile description, the profile ID and the status of the one click backup icon feature. You can click on the one click backup status icon to toggle that feature on the profile.

The Edit Profile page

When you click on a backup profile you can change its very basic information: the description and the one-click backup icon preference.

The description is something you see throughout the Akeeba Backup interface. Keep it short, unique and descriptive. It will help you understand which backup profile is currently active.

The one-click backup icon refers to the feature explained when describing the toolbar buttons.