123AIChat logo
123AIChat

Install / Linux

Linux installation guide

Recommended for private network servers and infrastructure pilot deployments.

Prerequisites

Installation steps

  1. 1Download the latest Linux tar.gz package.
  2. 2Extract package to your chosen deployment directory.
  3. 3Run start.sh in the extracted folder.
  4. 4Open the local URL printed in terminal output.
  5. 5Create admin account, add one channel, and validate one AI response.

Verification checklist

  • Service starts without process crash in terminal logs.
  • Web interface is reachable from expected internal clients.
  • Channel messaging and one AI reply are both confirmed.

Troubleshooting

Startup script exits immediately

Check execute permission and required runtime dependencies, then restart with terminal logs.

UI reachable but bots do not respond

Confirm model runtime availability and routing configuration in admin panel.

Rollback note

If the pilot environment is unstable, stop the process, archive logs for diagnosis, remove extracted files, and redeploy in a clean directory with validated dependencies.

Open admin runbookRequest onboarding help