Installation

Before installation, make sure your host meets the system requirements.

One-command installation

Run on your Linux server and follow the prompts:

curl -fsSL https://f.next-terminal.com/next-terminal/install.sh | sudo bash

After successful installation

Visit http://{ip}:8088/setup to initialize the admin user.

Visit http://{ip}:8088/login to sign in.

Stop services

Stop all services while retaining configuration and data:

sudo /opt/next-terminal/crt.sh stop

Start services

sudo /opt/next-terminal/crt.sh start

One-command upgrade

sudo /opt/next-terminal/crt.sh upgrade

The upgrade pulls images for all services in the current Compose configuration and updates containers as needed, including Next Terminal, PostgreSQL, and Guacd. Existing configuration and data are retained, and image tags are not changed. Connections may be interrupted; back up important data beforehand. For pinned image tags, edit the configured tag first to move to another version.

Database versions

Both PostgreSQL 16 and PostgreSQL 18 are supported. Existing PostgreSQL 16 deployments can continue using PostgreSQL 16 and do not need to migrate to PostgreSQL 18 in order to upgrade Next Terminal.

Make sure the PostgreSQL server major version matches the PostgreSQL client included in the Next Terminal image:

PostgreSQL server	Next Terminal image
postgres:16	dushixiang/next-terminal:latest
postgres:18	dushixiang/next-terminal:latest-pg18

If you use the Alibaba Cloud registry, keep the existing registry hostname and use the corresponding image tag.

Only required when migrating to PostgreSQL 18

If your existing docker-compose.yaml uses postgres:16, do not change it directly to postgres:18. PostgreSQL major versions cannot be upgraded by replacing the container image, and PostgreSQL 18 cannot use a PostgreSQL 16 data directory directly.

If you choose to migrate to PostgreSQL 18, follow Migrate from PostgreSQL 16 to PostgreSQL 18. Otherwise, keep your existing PostgreSQL 16 configuration.

Enable IPv6 (Optional)

See the official Docker documentation: https://docs.docker.com/engine/daemon/ipv6/