zxcas568/aquadx repository overview

⁠AquaDX

Multipurpose game server for ALL.Net games. Auto-update daily from GitHub⁠.

⁠Docker Compose Configuration

services:
  app:
    image: zxcas568/aquadx:latest
    ports:
      - "80:80"
      - "8443:8443"
      - "22345:22345"
    restart: on-failure:3
    environment:
      - SPRING_DATASOURCE_URL=jdbc:mariadb://db:3306/main
      - SPRING_DATASOURCE_USERNAME=cat
      - SPRING_DATASOURCE_PASSWORD=meow
      - SPRING_DATASOURCE_DRIVER_CLASS_NAME=org.mariadb.jdbc.Driver
    depends_on:
      - db
    volumes:
      - ./config:/app/config
      - ./data:/app/data

  db:
    image: mariadb:latest
    environment:
      MYSQL_ROOT_PASSWORD: meow
      MYSQL_DATABASE: main
      MYSQL_USER: cat
      MYSQL_PASSWORD: meow
    ports:
      - "${AQUADX_DB_PORT:-127.0.0.1:3369}:3306"
    volumes:
      - "${AQUADX_DB_DATA:-mariadb_data}:/var/lib/mysql"

volumes:
  mariadb_data:

⁠Docker Environment Variables

AquaDX

Multipurpose game server for ALL.Net games.

Related Projects

• AquaMai⁠: A maimai DX mod that adds many features to the game.
• AquaNet⁠: The primary AquaDX web frontend, hosted publically at aquadx.net⁠

Supported Games

Warning

CHUNITHM pre-NEW!! and maimai pre-DX are no longer supported after February 6th, 2026 and all associated data will be removed.

Check out these docs for more information.

• Game specific notes⁠
• Frequently asked questions⁠

Usage

Public Instance

1. Ensure your game can boot to title screen.
2. Go to https://aquadx.net⁠ and sign up (or log in).
3. Access the Setup Connection page⁠ and follow the instructions provided.

If you encounter any issue, please report via Discord, QQ, (both available on the website) or the GitHub issue tracker.

Tip

Your card's access code can be identified in all supported games on their title screen.

Press the "access code" and scan your card to retrieve it.

Self Hosting (Advanced)

Please read the self-hosting guide⁠ if you want to host your own server. This is only for advanced users and developers. Do not ask for support if you are not familiar with programming or networking.

License

AquaDX uses the CC By-NC-SA⁠ license:

• Attribution — You must give appropriate credit, provide a link to the license, and indicate if changes were made. You may do so in any reasonable manner, but not in any way that suggests the licensor endorses you or your use.
• NonCommercial — You may not use the material for commercial purposes.
• ShareAlike — If you remix, transform, or build upon the material, you must distribute your contributions under the same license as the original.

Attributions

• samnyan: The creator and developer of the original Aqua server
• Akasaka Ryuunosuke: providing all the DIVA protocol information
• Dom Eori: Developer of forked Aqua server, from v0.0.17 and up
• All devs who contribute to the MiniMe server⁠
• All contributors by merge requests, issues and other channels