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.
- 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.
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-adminYou 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.1You 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.
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 bashWhen 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/passwordYou 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-adminForgot your password? If you forget the fixed password, you can retrieve it by inspecting the service's configuration. The
systemctl status dwuicommand will show the original command you ran, including the password.
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.1The server will be available at http://<your-server-ip>:<port>.
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 bashThe 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 -- --forceTo 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 bashTo run the project in a development environment, you'll need two separate terminal sessions:
-
Run the Go backend with live-reloading:
air
-
Run the TailwindCSS compiler in watch mode:
npx @tailwindcss/cli -i ./tailwind.css -o ./assets/stylesheets/output.css --watch
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:
makeThis 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-amd64This 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.
This project is licensed under the AGPL v3.0 license. See the LICENSE file for more details.
Copyright (C) 2025 Romer Ramos

