Binary Installation

DeepLX can be installed as a standalone binary on Linux systems using the automated installation script or manual download.

Automated Installation

The easiest way to install DeepLX is using the official installation script.

Download and run the installation script

curl -fsSL https://raw.githubusercontent.com/OwO-Network/DeepLX/main/install.sh | bash

This script requires root/sudo access to install the binary to /usr/bin/ and set up the systemd service.

Verify installation

The script automatically:

Detects the latest DeepLX version from GitHub releases
Downloads deeplx_linux_amd64 to /usr/bin/deeplx
Makes the binary executable
Downloads and installs the systemd service file
Enables and starts the DeepLX service

systemctl status deeplx

Access the service

DeepLX is now listening on 0.0.0.0:1188

curl http://localhost:1188

Manual Installation

For more control over the installation process, you can manually download and install DeepLX.

Download the latest release

Visit the GitHub Releases page or download directly:

# Get the latest version
VERSION=$(curl -s https://api.github.com/repos/OwO-Network/DeepLX/releases/latest | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')

# Download the binary
wget https://github.com/OwO-Network/DeepLX/releases/download/${VERSION}/deeplx_linux_amd64

Replace deeplx_linux_amd64 with your platform’s binary if using a different architecture.

Install the binary

# Move to system binary directory
sudo mv deeplx_linux_amd64 /usr/bin/deeplx

# Make executable
sudo chmod +x /usr/bin/deeplx

Run DeepLX

deeplx

The service will start on the default port 1188.

Installation Script Details

The install.sh script performs the following operations:

install.sh

install_deeplx(){
    # Fetch latest version from GitHub API
    last_version=$(curl -Ls "https://api.github.com/repos/OwO-Network/DeepLX/releases/latest" | grep '"tag_name":' | sed -E 's/.*"([^"]+)".*/\1/')
    
    # Download binary to /usr/bin/deeplx
    wget -q -N --no-check-certificate -O /usr/bin/deeplx https://github.com/OwO-Network/DeepLX/releases/download/${last_version}/deeplx_linux_amd64

    # Make executable
    chmod +x /usr/bin/deeplx
    
    # Download systemd service file
    wget -q -N --no-check-certificate -O /etc/systemd/system/deeplx.service https://raw.githubusercontent.com/OwO-Network/DeepLX/main/deeplx.service
    
    # Enable and start service
    systemctl daemon-reload
    systemctl enable deeplx
    systemctl start deeplx
}

The installation script may fail if GitHub API rate limits are exceeded. If this occurs, wait a few minutes and try again, or use the manual installation method.

Command-Line Options

DeepLX supports several command-line flags for configuration:

Flag	Short	Description	Default	Example
`--ip`	`-i`	IP address to bind to	`0.0.0.0`	`--ip 127.0.0.1`
`--port`	`-p`	Port to listen on	`1188`	`--port 8080`
`--token`	-	Access token for `/translate` endpoint	-	`--token mytoken`
`-s`	-	DeepL session for `/v1/translate` endpoint	-	`-s session_id`
`--proxy`	-	HTTP proxy URL for requests	-	`--proxy http://proxy:8080`

Usage Examples

deeplx
# Listens on 0.0.0.0:1188

Environment Variables

Alternatively, you can configure DeepLX using environment variables:

export IP="0.0.0.0"
export PORT="1188"
export TOKEN="your_token"
export DL_SESSION="your_session"
export PROXY="http://proxy:8080"

deeplx

Command-line flags take precedence over environment variables if both are set.

Binary Locations

Component	Path	Description
Binary	`/usr/bin/deeplx`	Main executable
Service File	`/etc/systemd/system/deeplx.service`	systemd service configuration
Working Directory	`/usr/bin/`	Runtime working directory

Upgrading

To upgrade to the latest version:

Stop the service

sudo systemctl stop deeplx

Run the installation script again

curl -fsSL https://raw.githubusercontent.com/OwO-Network/DeepLX/main/install.sh | bash

Verify the new version

systemctl status deeplx

Uninstallation

To remove DeepLX from your system:

# Stop and disable the service
sudo systemctl stop deeplx
sudo systemctl disable deeplx

# Remove the binary
sudo rm /usr/bin/deeplx

# Remove the service file
sudo rm /etc/systemd/system/deeplx.service

# Reload systemd
sudo systemctl daemon-reload

Get Started

Deployment

Configuration

Binary Installation