Server Usage

The juicity-server handles incoming QUIC connections and proxies traffic.

Basic Command

juicity-server run -c <config_file_path>

Utility Commands

juicity-server includes helper commands to assist with configuration and deployment.

1. Generate Share Link

Generates a standard juicity:// share link based on your configuration file, which can be imported by clients.

juicity-server generate-sharelink [config_file]

2. Generate Certificate Chain Hash

If you are using self-signed certificates, you can pin the certificate hash on the client side for security. This command generates the required hash.

juicity-server generate-certchain-hash [fullchain_file]

Deployment with Docker

docker run --name juicity \
  --restart always \
  --network host \
  -v /path/to/config.json:/etc/juicity/server.json \
  -v /path/to/cert.pem:/path/to/fullchain.cer \
  -v /path/to/key.pem:/path/to/private.key \
  -dit ghcr.io/juicity/juicity:main

UUID Generation

Juicity requires valid UUIDs for user identification. You can generate one using Python or the uuidgen tool:

# Python
python3 -c "from uuid import uuid4;print(uuid4())"

# Linux CLI
uuidgen