Running 2 BaseX instances on same machine

Monday, 18 May 2026 · 3 messages
LA
Liedtke, Alexander18 May 2026 12:09 #

Hello everyone,

I have a question installing two instances on the same machine.

Does anybody have a recommendation for an installment, especially in regards on where to set/configure the ports (/home/basex/.basex file, start parameters, jetty.xml, etc.) for the secondary instance ?

I am using debian 13. BaseX is started as normal user.

Goal is to setup a system that works similar to Solr replication. Data is planned to be synched with rsync - or does there exist some kind of replication I did oversee?

Many thanks for any tips on this topic.

Best regards Alexander Liedtke

CG
Christian Grün18 May 2026 14:51 #

Hi Alexander,

If you use a global installation, you can define your “home directory” by creating an empty .basexhome or .basex in a folder. If you start BaseX from this directory, the global configuration settings will be ignored [1], and you can use completely different settings for custom instances of BaseX.

Hope this helps, Christian

[1] https://docs.basex.org/main/Configuration

LA
Liedtke, Alexander18 May 2026 16:19 #

Hi Christian,

thanks a lot.

Creating a .basexhome within the folder did the trick.

After first (expected failed) start up, a .basex file was automatically created, which allowed the further configuration.

I am using basexhttp - for that I had to add HTTPPORT = XYZ to the .basex file. Additionally I had to change the

jetty Port in jetty.xml under /webapp/WEB-INF.

Everything is working fine now! Thanks a lot!

Best regards

Alexander

Quoted text · Christian Grün · 10 lines
Von: Christian Grün <cg at basex.org> Gesendet: Montag, 18. Mai 2026 14:51:28 An: 'basex-talk at mailman.uni-konstanz.de'; Liedtke, Alexander Betreff: [EXT] AW: Running 2 BaseX instances on same machine EXTERNE E-MAIL - SEIEN SIE ACHTSAM BEIM ÖFFNEN VON LINKS UND ANHÄNGEN Hi Alexander, If you use a global installation, you can define your “home directory” by creating an empty .basexhome or .basex in a folder. If you start BaseX from this directory, the global configuration settings will be ignored [1], and you can use completely different settings for custom instances of BaseX. Hope this helps, Christian [1] https://docs.basex.org/main/Configuration

⚡Generated with XQuery