debben80/internxt-cli

•Updated 22 days ago

Image

2.5K

debben80/internxt-cli repository overview

⁠Internxt CLI Docker Image

This project provides a Docker image for running the Internxt CLI⁠ and launching a WebDAV server backed by your Internxt cloud storage. It is designed for secure, automated deployments and supports two-factor authentication (TOTP), non-root execution, and flexible configuration via environment variables or secret files.

⁠Features

Secure login to Internxt with email, password, and optional TOTP (2FA).
Automatic WebDAV server activation if no command is passed.
Flexible environment variable management (direct or via secret files).
Run any Internxt CLI command inside the container.
Non-root user execution for improved security.
Configurable WebDAV protocol, port, and logging level.
Configurable TimeZone.
Multi-arch builds for amd64 , arm64 and armv7.

⁠Prerequisites

An Internxt⁠ account.
Docker⁠ installed.

⁠Environment Variables

You can configure the container using the following environment variables:

Variable	Description	Required	Default
`INTERNXT_EMAIL`	Internxt login email.	Yes
`INTERNXT_PASSWORD`	Internxt login password.	Yes
`INTERNXT_TOTP_CODE`	TOTP code for two-factor authentication.	No
`INTERNXT_TOTP_SECRET`	TOTP secret for 2FA (INTERNXT_TOTP_CODE have priority)	No
`WEBDAV_HOST`	Listening host for WebDAV	No	`127.0.0.1`
`WEBDAV_PROTO`	Protocol for WebDAV (`http` or `https`).	No	`https`
`WEBDAV_PORT`	WebDAV listening port.	No	`3005`
`WEBDAV_LOGS`	Log level (`error` or `debug`).	No	`error`
`PUID`	User ID for running processes.	No	`1000`
`PGID`	Group ID for running processes.	No	`1000`
`TZ`	TimeZone for tzdata	No	`Etc/UTC`

Tip: For any INTERNXT_* variable above, you can use a corresponding *_FILE variable to load its value from a file (useful for secrets).

⁠Docker Images

Registry	Address ( tag : `latest` )
Docker Hub	`docker pull debben80/internxt-cli:latest`
GitHub Container Registry	`docker pull ghcr.io/debben80/internxt-cli:latest`

⁠Usage

⁠Start the WebDAV Server

docker run -d \
  -e [email protected] \
  -e INTERNXT_PASSWORD=mypassword \
  -e INTERNXT_TOTP_SECRET=myTOTPsecret \
  debben80/internxt-cli

⁠Run Internxt CLI Commands

You can run any Internxt CLI command by passing it as arguments:

docker run --rm \
  -e [email protected] \
  -e INTERNXT_PASSWORD=mypassword \
  -e INTERNXT_TOTP_CODE=myTOTPcode \
  debben80/internxt-cli internxt list

⁠Using Secrets

To use secrets, mount files and set the corresponding *_FILE environment variable:

docker run -d \
  -e INTERNXT_EMAIL_FILE=/run/secrets/email \
  -e INTERNXT_PASSWORD_FILE=/run/secrets/password \
  -v /run/secrets:/run/secrets:ro \
  debben80/internxt-cli

⁠Docker Compose Example

services:
  internxt-webdav:
    image: debben80/internxt-cli:latest
    environment:
      INTERNXT_EMAIL: [email protected]
      INTERNXT_PASSWORD: yourpassword
    ports:
      - "3005:3005"
    restart: unless-stopped

⁠Security Notes

The container runs as a non-root user (appuser).
Secrets can be injected via files for improved security.
Always use secure passwords and enable TOTP if possible.

⁠Development

The Docker image is built using Alpine Linux⁠.
The Internxt CLI is installed via npm.
Entrypoint and helper scripts are located in app/entrypoint.sh⁠, app/functions.sh⁠, and app/webdav.sh⁠.

⁠References

⁠License

This project is licensed under the MIT License - see the LICENSE⁠ file for details.

Tag summary

Recent tags

Content type

Image

Digest

sha256:44297d7bd…

Size

67.5 MB

Last updated

22 days ago

docker pull debben80/internxt-cli