Skip to content
romerramosPublic

About

Really simple docker web ui

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

DWUI: Docker Web UI

DWUI Logo

DWUI is a simple web interface for Docker that gives you a "Docker Desktop" like experience, right on your server. It's designed to be lightweight, easy to use, and a perfect companion for deployment tools like Kamal.

Born out of a need for a no-fuss container management tool, DWUI aims to be simple, effective, and open to the community.

In Action

DWUI Logo

Features

  • View Containers: See all your running containers and their status at a glance.
  • Inspect Details: Check environment variables and open ports.
  • Real-time Logs: Stream container logs directly in your browser.
  • Web Terminal: Open an interactive terminal into your containers.
  • Single Binary: No dependencies or complex setup. Just one file to run.
  • Kamal-Friendly: A great companion to your Kamal deployment workflow.
  • Responsive: Access it from your desktop or on the go from your phone.

Run without Installing

You can run DWUI without a persistent installation using a single command. This will download the correct binary for your system (macOS or Linux), make it executable, and run it.

Make sure to replace dwui-admin with a strong password.

curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/run.sh | bash -s -- --password dwui-admin

You can also specify a custom port or version:

# Run on port 9000
curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/run.sh | bash -s -- --password dwui-admin --port 9000

# Run a specific version
curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/run.sh | bash -s -- --password dwui-admin --version v0.0.1

Installation

You can install DWUI as a systemd service on your Linux server. This will download the binary, set it up to run as a service, and start it automatically.

With a Dynamic Password

If you prefer, you can configure the service to generate a new random password every time it starts or restarts. To do this, simply omit the --password flag during installation:

curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/install.sh | sudo bash

When using a dynamic password, the generated password will be stored in /var/lib/dwui/password. You can retrieve the current password with:

sudo cat /var/lib/dwui/password

With a Fixed Password

You can set a fixed password during installation. Make sure to replace dwui-admin with a strong password of your choice.

curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/install.sh | sudo bash -s -- --password dwui-admin

Forgot your password? If you forget the fixed password, you can retrieve it by inspecting the service's configuration. The systemctl status dwui command will show the original command you ran, including the password.

Custom Port and Version

You can also specify a custom port or version for both fixed and dynamic password installations:

# Install on a custom port (e.g., 9000)
curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/install.sh | sudo bash -s -- --port 9000

# Install a specific version with a fixed password
curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/install.sh | sudo bash -s -- --password dwui-admin --version v0.0.1

The server will be available at http://<your-server-ip>:<port>.

Updating

To update DWUI to the latest version, you can use the update script:

curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/update.sh | sudo bash

The update script will:

  • Automatically detect the current version
  • Download the latest version
  • Create a backup of the current binary
  • Stop the service, update the binary, and restart the service
  • Clean up old backup files (keeping the 3 most recent)

You can also specify a specific version or force an update:

# Update to a specific version
curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/update.sh | sudo bash -s -- --version v0.0.1

# Force update (even if already on the target version)
curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/update.sh | sudo bash -s -- --force

Uninstallation

To remove DWUI and the associated service from your server, you can use the uninstallation script:

curl -sSL https://raw.githubusercontent.com/romerramos/dwui/main/dist/uninstall.sh | sudo bash

Development

To run the project in a development environment, you'll need two separate terminal sessions:

  1. Run the Go backend with live-reloading:

    air
  2. Run the TailwindCSS compiler in watch mode:

    npx @tailwindcss/cli -i ./tailwind.css -o ./assets/stylesheets/output.css --watch

Building from Source

To build the binaries from source, you'll need Go and Make installed on your system. You can build for all supported platforms with a single command:

make

This will place all the binaries in the ./dist directory. You can also build for a specific platform:

# Build for Mac (Apple Silicon)
make mac-arm64

# Build for Linux (amd64)
make linux-amd64

# Build for Windows (amd64)
make windows-amd64

Contributing

This project was built to solve a personal need and as a Go learning experience. Contributions, feedback, and suggestions from the community are highly welcome! Feel free to open an issue or a pull request.

License

This project is licensed under the AGPL v3.0 license. See the LICENSE file for more details.

Copyright (C) 2025 Romer Ramos

About

Really simple docker web ui

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages