Docker Deployment

DeepLX can be deployed using Docker with either the pre-built image or by building from source.

Using Pre-built Image

The official Docker image is available on GitHub Container Registry.

Pull the Docker image

docker pull ghcr.io/owo-network/deeplx:latest

Run the container

docker run -d -p 1188:1188 ghcr.io/owo-network/deeplx:latest

The service will be available at http://localhost:1188

Run with environment variables (optional)

docker run -d \
  -p 1188:1188 \
  -e TOKEN=your_token \
  -e DL_SESSION=your_session \
  ghcr.io/owo-network/deeplx:latest

Using Docker Compose

For easier management, use Docker Compose with the provided configuration.

Create compose.yaml file

compose.yaml

services:
  deeplx:
    image: ghcr.io/owo-network/deeplx:latest
    restart: always
    ports:
      - "1188:1188"
    # environment:
      # - TOKEN=helloworld
      # - DL_SESSION=xxxxxx

Start the service

docker compose up -d

Check the logs

docker compose logs -f deeplx

Building from Source

You can build your own Docker image using the provided Dockerfile.

Clone the repository

git clone https://github.com/OwO-Network/DeepLX.git
cd DeepLX

Build the Docker image

The Dockerfile uses a multi-stage build process:

Dockerfile

FROM golang:1.24.2 AS builder
WORKDIR /go/src/github.com/OwO-Network/DeepLX
COPY . .
RUN go get -d -v ./
RUN CGO_ENABLED=0 go build -a -installsuffix cgo -o deeplx .

FROM alpine:latest
WORKDIR /app
COPY --from=builder /go/src/github.com/OwO-Network/DeepLX/deeplx /app/deeplx
CMD ["/app/deeplx"]

Build the image:

docker build -t deeplx:custom .

Run your custom image

docker run -d -p 1188:1188 deeplx:custom

Environment Variables

DeepLX supports the following environment variables for configuration:

Variable	Description	Default	Example
`IP`	IP address to bind to	`0.0.0.0`	`127.0.0.1`
`PORT`	Port to listen on	`1188`	`8080`
`TOKEN`	Access token for `/translate` endpoint	-	`helloworld`
`DL_SESSION`	DeepL session for `/v1/translate` endpoint	-	`your_session_id`
`PROXY`	HTTP proxy URL for requests	-	`http://proxy:8080`

When using environment variables in Docker Compose, uncomment the environment section in compose.yaml and set your values.

Port Configuration

By default, DeepLX listens on port 1188. To use a different port:

Docker Run
Docker Compose
Environment Variable

docker run -d \
  -p 8080:1188 \
  ghcr.io/owo-network/deeplx:latest

Access at http://localhost:8080

services:
  deeplx:
    image: ghcr.io/owo-network/deeplx:latest
    restart: always
    ports:
      - "8080:1188"

docker run -d \
  -p 8080:8080 \
  -e PORT=8080 \
  ghcr.io/owo-network/deeplx:latest

Container Management

docker compose down

Get Started

Deployment

Configuration

Docker Deployment