Load dump file into neo4j

Hi,

I cannot load from dump-file to docker using neo4j-admin in docker neo4j:ubi9 :

How can I resolve this issue?

> bash-5.1$ neo4j-admin database load --from-path=/data/dump --overwrite-destination=true neo4j
Failed to load database 'neo4j': No matching archives found

Load failed for databases: 'neo4j'

Command Failed
Load failed for databases: 'neo4j'

No matching archives found

@dyim

hopefully this isnt a bug but if it is it would be helpful to know what version of Neo4j is in play here?

also given --from-path=/data/dump can you please list the contents of /data/dump?

@dana_canzano

I downloaded from docker-hub: https://hub.docker.com/\_/neo4j with ubi9.

the version showed as “20260202”. It is weird.

bash-5.1$ neo4j --version
2026.02.2

bash-5.1$ neo4j-admin --version
2026.02.2

bash-5.1$ ls -al /data/dump
total 112
drwxr-xr-x 2 neo4j neo4j 4096 Mar 17 01:58 .
drwxrwxr-x 5 neo4j neo4j 4096 Mar 17 00:46 ..
-rwxrwxrwx 1 neo4j neo4j 51593 Mar 17 01:57 neo4j-2026-03-17T01-55-00.dump

I think the docker image is community edition so only neo4j is the only database in this image.

Is there neo4j docker hub site other than “https://hub.docker.com/_/neo4j” ?

@dyim

correct . docker-hub: https://hub.docker.com/\_/neo4j with ubi9. is where you need to get the Neo4j containter.

And yes community only supports a single user database, but as you have –overwrite-destination=true it should replace the existing neo4j database.

But the error of No matching archives found suggests the .dump file is not correct. How was the .dump generated?

If you rerun neo4j-admin database load but include --verbose does this provide any further clues?

@dana_canzano

I attach some: 
Failed to load database 'neo4j': No matching archives found 
load failed for databases:'neo4j'
org.neo4j.cli.CommandFailedException: Load failed for databases: 'neo4j'

No matching archives found. 

I make .dump file from windows and load the .dump file to the container in linux. Does it matter with this error?

@dana_canzano

I attach some: 
Failed to load database 'neo4j': No matching archives found 
load failed for databases:'neo4j'
org.neo4j.cli.CommandFailedException: Load failed for databases: 'neo4j'

No matching archives found. 

I make .dump file from windows and load the .dump file to the container in linux. Does it matter with this error?


2026-03-19 06:34:30.837+0000 ERROR Fatal exception thrown
org.neo4j.cli.CommandFailedException: Load failed for databases: 'neo4j'

No matching archives found

    at org.neo4j.commandline.dbms.LoadCommand.checkFailure(LoadCommand.java:293)
    at org.neo4j.commandline.dbms.LoadCommand.loadDump(LoadCommand.java:281)
    at org.neo4j.commandline.dbms.LoadCommand.loadDump(LoadCommand.java:243)
    at org.neo4j.commandline.dbms.LoadCommand.execute(LoadCommand.java:176)
    at org.neo4j.cli.AbstractAdminCommand.wrappedExecute(AbstractAdminCommand.java:218)
    at org.neo4j.cli.AbstractCommand.call(AbstractCommand.java:103)
    at org.neo4j.cli.AbstractCommand.call(AbstractCommand.java:43)
    at picocli.CommandLine.executeUserObject(CommandLine.java:2031)
    at picocli.CommandLine.access$1500(CommandLine.java:148)
    at picocli.CommandLine$RunLast.executeUserObjectOfLastSubcommandWithSameParent(CommandLine.java:2469)
    at picocli.CommandLine$RunLast.handle(CommandLine.java:2461)
    at picocli.CommandLine$RunLast.handle(CommandLine.java:2423)
    at picocli.CommandLine$AbstractParseResultHandler.execute(CommandLine.java:2277)
    at picocli.CommandLine$RunLast.execute(CommandLine.java:2425)
    at picocli.CommandLine.execute(CommandLine.java:2174)
    at org.neo4j.cli.AdminTool.execute(AdminTool.java:94)
    at org.neo4j.cli.AdminTool.main(AdminTool.java:82)

Caused by: org.neo4j.cli.CommandFailedException: No matching archives found

    at org.neo4j.commandline.dbms.LoadCommand.loadDump(LoadCommand.java:265)
    ... 15 more

"No matching archives found" is meaning what ?

@dyim

i tried to replicate the failure of

No matching archives found

this can happen if

a. —from-path is empty. and this would make sense since if it is empty there is no .dump file

b. the file in –from-path is a dump file not defined with a .dump extension. i.e. a neo4j.dmp would not be recognized as a valid dump

c. the file in –from-path is not named .dump. i.e. neo4j-2026-03-20.dump would generate this error

Tip
   	
The command looks for a file called <database>.dump where <database> is the database specified in the command.
As of Neo4j 5.20, the command also looks for a full backup artifact.

@dana_canzano

Let me share the steps what I am doing:
I am using neo4j:latest from docker hub.

$ docker exec -u neo4j -it d4a99866128a bash
$neo4j@d4a99866128a:~$ ls -al /data/dump
total 60
drwxrwxrwx 2 neo4j neo4j 4096 Mar 19 07:46 .
drwxrwxr-x 5 neo4j neo4j 4096 Mar 17 00:46 ..
-rwxrwxrwx 1 neo4j neo4j 51671 Mar 19 00:27 neo4j.dump
neo4j@d4a99866128a:~$ neo4j-admin database load neo4j --from-path=/data/dump --overwrite-destination=true
Failed to load database 'neo4j': The database is in use. Stop database 'neo4j' and try again.

Lock file has been locked by another process: /data/databases/neo4j/database_lock. Please ensure no other process is using this database, and that the directory is writable (required even for read-only access)

Load failed for databases: 'neo4j'

Command Failed
Load failed for databases: 'neo4j'

The database is in use. Stop database 'neo4j' and try again.

Lock file has been locked by another process: /data/databases/neo4j/database_lock. Please ensure no other process is using this database, and that the directory is writable (required even for read-only access)


Now I have different message. I am using docker:latest which community edition.
How can I load .dump file into the Database during docker is running?

I received an error : Is there any way to use docker image with my data ?

user01@user01-400TDA-400SDA:/data/neo4j$ docker run -it --publish=7474:7474 --publish=7687:7687 -v /data/neo4j/data:/data -v /tmp:/import neo4j:latest neo4j-admin database load neo4j --from-path=/import --overwrite-destination=true
Done: 66 files, 1.503MiB processed in 0.050 seconds.
Failed to load database 'neo4j': Block format detected for database neo4j but unavailable in this edition.
Load failed for databases: 'neo4j'

Command Failed
Load failed for databases: 'neo4j'

Block format detected for database neo4j but unavailable in this edition.

@dyim

You can not run neo4j-admin database load …. into a database that is online.
If you run cypher statment

stop database <databaseName>;

replacing with the actual name then when you run neo4j-admin database load … you will no longer encounter the error.

. It is not possible to replace a database that is mounted in a running Neo4j server. 

@dana_canzano I am using docker:latest which is community edition.

“stop database” is not supported by community edition. Only enterprise Edition supports.

neo4j@system> stop database neo4j
;
51N27: system configuration or operation exception - not supported in this edition. 'STOP DATABASE' is not supported in community edition.

I foudn “Neo4J desktop” in windows is enterprise edition. The current neo4j:latest is community edition.

The dump file is block format from neo4j enterprise edition. So docker:latest community edition cannot load the dump which is generated from neo4j EE.

It is very strange for me to start to evaluate neo desktop in windows and consider deploying on Linux. If it is not fact, please correct me.

BLOCK storage format between AuraDB and Community editions · Issue #13444 · neo4j/neo4j · GitHub (by mauvo (David Pond) · GitHub )

neo4j-admin is packaged with Neo4j EE and CE - but youby need the EE version since CE doesn't have the ability to read Block format yet. It's in the /bin folder alongside the main neo4j application.

I wondered if Neo4j Desktop would meet your developer's needs instead of Docker. And, less straight-forwardly, if it would be a good place to start a conversation with your account manager. It's better for everyone if you can use EE rather than CE. That said, any license cost would depend on the details of how you're currently using CE.