Backup Management

Opensolr Backup Management — find answers to your questions

Download backup files

Backup files are downloaded over HTTPS, not through an API endpoint. Sign in with the username and password of the index, the ones in its Security tab.

Folderhttps://backup.opensolr.com/INDEX_NAME/
One filehttps://backup.opensolr.com/INDEX_NAME/FILE_NAME
Sign inThe HTTP Basic Auth username and password of the index: HTTP Basic Auth.

01 · Find the file name

Call get_backup_files_list, or open the folder of the index in a browser: it lists every backup file.

02 · Example

curl -u "INDEX_USERNAME:INDEX_PASSWORD" -o my_index_10_11_2026-02.00.09.tar \
  "https://backup.opensolr.com/my_index/my_index_10_11_2026-02.00.09.tar"

A new index starts with the username opensolr and your master API key as its password. If you changed them, use the new ones.

03 · Related

Make a backup: create_backup. Restore one: restore_backup.

How long backup files are kept, and the steps in the Control Panel: Download backup files.

Read Full Answer

API - Get list of backup files

Lists the backup files of your Opensolr Index. You need a file name from this list to restore a backup or to download it.

Endpointhttps://opensolr.com/solr_manager/api/get_backup_files_list
MethodGET
Authemail and api_key of your account, as GET or POST parameters: Authentication.
In the panelBackup

01 · Parameters

core_nameRequired

The name of your index.

02 · Example

curl -s "https://opensolr.com/solr_manager/api/get_backup_files_list?email=YOUR_EMAIL&api_key=YOUR_API_KEY&core_name=my_index"

03 · Answer

{
    "status": true,
    "msg": [
        "my_index_10_10_2026-02.00.11.tar",
        "my_index_10_11_2026-02.00.09.tar"
    ]
}

The names carry the date and time the backup was made (month, day, year, then hour, minute, second). An index with no backup answers an empty list.

04 · Errors

NOT_ALLOWEDHTTP 200

Your plan has no backups.

NOT_OWNER_ERRORHTTP 200

The index is not yours.

ERROR_AUTHENTICATION_FAILEDHTTP 403

The email and API key do not match.

ERROR_RATE_LIMIT_PER_MINUTEHTTP 429

Too many calls. Wait for the Retry-After seconds: Rate limits.

05 · Related

Make one: create_backup. Restore one: restore_backup. Download one: Download backup files.

Every error code and HTTP status of the API: API errors. Calls per minute and per hour: Rate limits.

Read Full Answer

API - Create backup

Makes a backup of your Opensolr Index, its data and its configuration files, the same as Create New Backup in the Control Panel.

Endpointhttps://opensolr.com/solr_manager/api/create_backup
MethodGET
Authemail and api_key of your account, as GET or POST parameters: Authentication.
In the panelMake a backup

01 · Parameters

core_nameRequired

The name of your index.

02 · Example

curl -s "https://opensolr.com/solr_manager/api/create_backup?email=YOUR_EMAIL&api_key=YOUR_API_KEY&core_name=my_index"

03 · Answer

{
    "status": true,
    "msg": "Your backup file will be created momentarily."
}

The backup is queued and made in the background. When it is ready, its file is in get_backup_files_list, named after the index and the time it was made, for example my_index_10_11_2026-14.05.33.tar.

04 · Errors

NOT_ALLOWEDHTTP 200

Your plan has no backups.

ERROR_NOT_CORE_OWNERHTTP 200

The index is not yours.

ERROR_AUTHENTICATION_FAILEDHTTP 403

The email and API key do not match.

ERROR_RATE_LIMIT_PER_MINUTEHTTP 429

Too many calls. Wait for the Retry-After seconds: Rate limits.

05 · Related

Restore a backup: restore_backup. Download one: Download backup files.

A backup every day without calling the API: Daily backup schedule.

Every error code and HTTP status of the API: API errors. Calls per minute and per hour: Rate limits.

Read Full Answer

Loading more articles...