Free tools Windows power users keep installed
One-click scans. No signup required.
The most maintainable way to install Docker Compose on a Linux VPS is to install Docker Engine and the Compose plugin from Docker’s official APT repository. On a supported 64-bit Ubuntu or Debian server, install the engine, CLI, container runtime, Buildx, and docker-compose-plugin together, verify the daemon, then run your project with the current docker compose (space-separated) command.
Antihost offers VPS plans with one-click Docker, NVMe storage and a 14-day free trial.
What Docker Compose is on a VPS
Docker Compose is the project workflow for defining several containers, their networks, volumes, environment variables, and published ports in one YAML file. The current Linux implementation is a Docker CLI plugin, so you invoke it as docker compose. Older tutorials often use the hyphenated docker-compose command; that is the legacy syntax and should not be your default for a new installation.
As an Amazon Associate I earn from qualifying purchases.
Compose does not replace Docker Engine. The engine runs containers and owns the daemon, images, networks, and volumes; the Compose plugin reads your project file and asks the engine to create and manage that application stack. Installing only a standalone Compose binary without an engine leaves you without the daemon required to run containers.
Check VPS compatibility before installing
Supported operating systems and architectures
Docker’s current Ubuntu instructions list Ubuntu 26.04, 24.04, and 22.04, with amd64, armhf, arm64, s390x, and ppc64le packages. Use a 64-bit release supported by Docker rather than an end-of-life image supplied by a VPS image catalog. For Debian, the installation guide covers Debian 13 (stable) and Debian 12 (oldstable): Docker’s Debian installation guide.
#1 Best Overall
- BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
- EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
- COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
- LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
- WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.
Connect as a normal administrative user with sudo. You need outbound access to the package repository and, when a Compose project pulls images, access to the relevant container registry. Record your application data locations before changing packages; removing conflicting packages does not automatically delete Docker’s existing /var/lib/docker data.
Confirm the distribution and CPU architecture
cat /etc/os-release
uname -m
getent architecture 2>/dev/null || dpkg --print-architectureOn Debian or Ubuntu, dpkg --print-architecture should report the architecture for which you are installing packages. If your VPS is running an unsupported release or architecture, switch to a supported image before proceeding.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Scan for outdated or missing drivers - takes under a minuteDriver Scan →Clear out junk files and repair common Windows errorsFree Scan →Choose an installation approach
| Approach | Updates | Version control | When it fits |
|---|---|---|---|
| Docker’s APT repository | Package-manager updates keep Engine and the Compose plugin maintainable alongside the rest of the host. | You can select matching package versions when you need to pin a release. | Recommended for most long-lived VPSs. |
| Manual Compose binary | Does not update automatically; you must replace the binary yourself. | You control the downloaded binary, but upgrades and rollback are a separate process. | Useful only when repository packages cannot be used and you accept the maintenance work. |
| Rootful Docker | The normal package installation runs the Docker daemon with system privileges. | Works with the standard plugin and service commands below. | The straightforward choice for a single-purpose server, provided socket and port access are tightly controlled. |
| Rootless Docker | Runs the daemon in an unprivileged user context, requiring additional setup outside this basic repository workflow. | Can reduce the impact of a daemon compromise, but networking, service startup, and storage behavior need separate validation. | Choose it when your operating model specifically requires an unprivileged daemon and you can support that extra complexity. |
Docker’s Linux Compose guidance recommends the repository route for easier maintenance. Do not install a distribution’s old docker-compose package and the official plugin indiscriminately; mixed packages are a common source of conflicting commands and versions.
Install Docker Compose on Ubuntu
1. Remove conflicting packages
Run Docker’s conflict-removal command before adding the official repository:
sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc docker-buildx podman-docker containerd runc | cut -f1)The command removes packages that can conflict with Docker’s official Engine and plugin packages. It does not automatically remove the contents of /var/lib/docker. Review the proposed package changes before confirming, particularly on a VPS that already hosts containers.
2. Add Docker’s signing key and APT source
Install the certificate and transfer tools, create the keyring directory, download Docker’s signing key, and register the repository. The heredoc derives the correct Ubuntu codename and architecture from the running system.
Recommended Free Tools
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF
sudo apt updateCheck that the final apt update completes without a signature, suite, or architecture error. Such errors usually mean the VPS release is not supported, the codename is wrong, or the key file is unreadable.
3. Install Engine, containerd, Buildx, and Compose together
sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-pluginInstalling these packages as one set keeps the CLI, daemon, runtime, Buildx builder, and Compose plugin aligned. If you must reproduce a deployment exactly, Docker also documents selecting matching versions from the available docker-ce package versions rather than accepting the newest package automatically. Record the versions you deploy so a later rollback is deliberate rather than accidental.
Rank #2
- WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
- AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
- PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
- ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
- COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
4. Start and verify the daemon
sudo systemctl status docker
sudo systemctl start docker # only if it is not running
sudo docker run hello-world
docker compose versionsystemctl status docker shows whether the service is active. Start it only when it is stopped. The hello-world container downloads a test image, runs it, prints a confirmation message, and exits. Finally, docker compose version confirms that the CLI can load the plugin.
5. Decide how users access the Docker socket
Keep administrative access limited to trusted users. A permission error from an ordinary account means the daemon socket and your user/group policy need attention; it is not a reason to make the socket publicly reachable. If you use a rootless design, follow that design consistently instead of mixing rootful and rootless daemons in the same project directory.
Do these 3 things before closing this tab:
1Fix the driver behind crashes, sound loss and screen glitches2Clear out junk files and repair common Windows errors3Scan for outdated or missing drivers - takes under a minuteInstall on Debian
Use the same package set and verification sequence on Debian, but follow the Debian repository instructions rather than copying the Ubuntu suite and URL. Docker’s guide covers Debian 13 (stable) and Debian 12 (oldstable): https://github.com/docker/docs/blob/main/content/manuals/engine/install/debian.md.
- Remove conflicting packages listed in Docker’s Debian prerequisites.
- Add Docker’s Debian signing key and the stable repository for your Debian codename and architecture.
- Install
docker-ce,docker-ce-cli,containerd.io,docker-buildx-plugin, anddocker-compose-plugin. - Run
sudo systemctl status docker; start the service if necessary. - Run
sudo docker run hello-worldand thendocker compose version.
Do not substitute Ubuntu’s docker.sources entry on Debian. Repository suites are distribution-specific, and an incorrect suite can produce missing-package or dependency errors.
Create your first Compose project
1. Make a dedicated project directory
mkdir -p ~/compose-demo
cd ~/compose-demoKeep the Compose file, environment configuration, and operational notes together. A project directory is also the context from which Compose resolves the default file and project name.
2. Create compose.yaml
Compose accepts either compose.yaml or the older docker-compose.yml filename. This minimal service publishes the container’s port 80 on VPS port 8080:
PC Slower Than It Used to Be?
A free scan shows the junk files, broken settings and background clutter dragging Windows down - then fixes them in one click.Free scan · Windows 10 & 11Outdated Drivers Are Slowing You Down
One free scan finds every outdated or missing driver and matches the right update for your exact hardware.Free scan · exact hardware matchservices:
web:
image: nginx:alpine
ports:
- "8080:80"The left side of the mapping is the host port; the right side is the port inside the container. Publishing a port makes it reachable through the VPS networking path, subject to Docker’s firewall behavior described below.
3. Validate before starting
docker compose configconfig renders the resolved Compose model and catches YAML or interpolation errors before containers are created. Fix every error it reports rather than debugging a partially started stack.
Rank #3
- Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
- Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
- Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
- ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
- Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)
4. Pull images and start the stack
docker compose pull
docker compose up -dpull downloads the image versions referenced by the file. up -d creates the project network and containers and leaves them running in the background. For an interactive first run, omit -d so startup output remains in the terminal.
5. Inspect, follow logs, and stop safely
docker compose ps
docker compose logs -f
docker compose downpsshows the project containers and their current state.logs -ffollows service output until you stop following it withCtrl+C.downremoves the project containers and network. Named volumes remain unless you explicitly remove them, so persistent data is not deleted by an ordinary shutdown.
Plan a predictable deployment cycle
A reliable VPS workflow separates validation, image retrieval, startup, and exposure. First run docker compose config from the directory containing the intended file. This confirms that YAML syntax and variable interpolation resolve as expected. Next run docker compose pull while you still have a chance to inspect image-download errors. Only then run docker compose up -d.
The Tool Desk
Outbyte PC Repair FREERepair Windows errors before they cause bigger problemsFix Now →Outbyte Driver Updater FREEScan for outdated or missing drivers - takes under a minuteDriver Scan →After startup, use docker compose ps to check every service rather than assuming that a successful command means the application is healthy. Follow docker compose logs -f during the first launch and after changes. If a service exits, the logs usually identify a missing setting, failed connection, or port conflict that is not visible from the shell prompt.
For a maintenance window, record the current Compose file, package versions, image tags, and data locations. Pull and recreate one planned change at a time when possible. If an update behaves unexpectedly, the recorded versions and unchanged named volumes give you a clear point from which to investigate or roll back. Do not delete volumes while experimenting unless you have a verified backup and intend to remove the data.
Use the project directory consistently when running commands. Running Compose from another directory can make it use a different file or project context, leading to confusing results such as missing services or apparently empty networks. Keep secrets and environment files readable only by the accounts that need them, and avoid placing credentials directly in shell history or public documentation.
Use ports and firewalls safely on a VPS
Published Docker ports are a security boundary, not merely an application setting. Docker warns that exposed container ports can bypass rules you expected ufw or firewalld to enforce. Before making a service public, review Docker’s firewall behavior and use the iptables/ip6tables DOCKER-USER chain for filtering that must apply before Docker’s own forwarding rules.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
- Publish only the reverse-proxy or application ports that must be reachable from the Internet.
- Keep databases, queues, dashboards, and administration endpoints on internal Compose networks or private interfaces unless public access is a deliberate requirement.
- Check your VPS provider’s security-group or network ACL rules as well as the host firewall.
- Use SSH keys and an ordinary sudo-capable account for administration; avoid routine direct root logins.
- Update the host packages and container images, and back up named volumes and application data.
For a quick test, opening port 8080 in a browser or with an HTTP client is useful only after you have intentionally allowed that exposure. A service that is “working” locally can still be unintentionally public on a VPS.
Operate a Compose stack after installation
Updating images without guessing what changed
Run docker compose pull when you want newer image content, then recreate the services with docker compose up -d. Review image tags and release notes before updating production workloads. Avoid changing several unrelated services at once when you need a clear rollback point.
Rank #4
- Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
- Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
- 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
- Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
- USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC
Preserving data
Containers are replaceable; named volumes and bind-mounted application directories are where state normally lives. Include those paths in your backup plan. Because a normal docker compose down leaves named volumes, it is suitable for stopping a project without intentionally destroying its stored data.
Making the project reproducible
Keep the exact Compose file and any required environment values under controlled access. Pin image tags when an unplanned upstream update would be unacceptable, and document the Docker Engine, Compose plugin, and image versions used for a release. The repository installation is easier to maintain, while explicit package-version selection provides a way to hold a known-good host version when required.
Troubleshoot common failures
docker compose: command not found
Confirm that the plugin package is installed:
sudo apt install docker-compose-plugin
docker compose versionIf the package cannot be found, check that the official repository matches your distribution codename and architecture, then run sudo apt update. Do not “fix” the issue by reverting to an unrelated legacy docker-compose package without understanding the version difference.
Permission denied on the Docker socket
First check whether the daemon is running with sudo systemctl status docker. If it is active, review which user is invoking the command and your Docker socket/group policy. Do not expose the Docker socket over a network or grant broad access as a shortcut; control of that socket is effectively control of the Docker host.
Compose starts but the site is unreachable
- Run
docker compose psand confirm the service is running. - Run
docker compose logs -fand look for an application bind or startup error. - Verify the host-to-container port mapping in the Compose file.
- Check VPS security-group rules and host firewall policy.
- Confirm that the application listens on the container interface and that you are testing the VPS’s actual public address.
Port already allocated
Another process or container is already using the host-side port. Change the left-hand port in the mapping—for example, use 8081:80 instead of 8080:80—or stop the competing service after confirming it is safe to do so. The container-side port usually remains the port expected by the application.
Package conflicts during installation
Remove the conflicting packages from Docker’s prerequisite list, refresh APT metadata, and install the official package set together. Mixing distribution Engine packages, third-party binaries, and the official plugin can leave you with a daemon and CLI that do not agree about features or locations.
Old instructions use docker-compose
Use the current space-separated plugin form: docker compose up, docker compose ps, and docker compose logs. If a project’s documentation still uses the hyphenated command, translate it to the plugin syntax after confirming that docker compose version works on the VPS.
Installation checklist
- Supported 64-bit Ubuntu or Debian release and architecture confirmed.
- Conflicting packages removed without deleting required Docker data.
- Official repository key and distribution-specific source configured.
docker-ce, CLI,containerd.io, Buildx, and Compose plugin installed together.- Daemon active,
hello-worldcompleted, anddocker compose versionreturned a version. - Compose file validated with
docker compose config. - Only required ports published and firewall/security-group behavior reviewed.
- Named volumes and application data included in backups.
Frequently Asked Questions
How do I install Docker Compose on an Ubuntu VPS?
Use Docker’s official Ubuntu APT repository, remove conflicting packages, and install docker-ce, docker-ce-cli, containerd.io, docker-buildx-plugin, and docker-compose-plugin. Verify the daemon with sudo systemctl status docker, run sudo docker run hello-world, and confirm the plugin with docker compose version.
Best Value
- Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
- Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
- Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
- Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
- Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
What is the difference between docker compose and docker-compose?
docker compose is the current Docker CLI plugin syntax. docker-compose is the older standalone command used by legacy instructions. Prefer the space-separated command on a new VPS and avoid mixing packages from both installation methods.
Can I use this procedure on Debian?
Yes. Docker’s Debian guide covers Debian 13 stable and Debian 12 oldstable. Follow the Debian repository instructions and use the same Engine, CLI, containerd, Buildx, and Compose package set. Do not copy the Ubuntu repository suite or URL into a Debian system.
Why does Docker Compose say command not found after installation?
Check that docker-compose-plugin is installed, then run docker compose version. If APT cannot find the package, verify the Docker repository’s distribution codename and CPU architecture, run sudo apt update, and remove conflicting distribution packages.
Why can I run Compose with sudo but not as my normal user?
The normal rootful daemon protects its Unix socket. Check that Docker is running and review your user and group policy. Do not expose the socket over the network or grant unrestricted access as a shortcut; access to the socket provides control of the Docker host.
Why is my Compose website unreachable from the Internet?
Check docker compose ps, inspect docker compose logs -f, verify the host-side port mapping, and review both the VPS security group and host firewall. Docker-published ports can bypass expected ufw or firewalld rules, so apply filtering with the documented Docker firewall approach and the DOCKER-USER chain.
Does docker compose down delete my database data?
A normal docker compose down removes the project containers and network but leaves named volumes. Data in bind-mounted directories also remains. Delete volumes only deliberately and only after confirming that backups are available.
Should I install Docker Compose manually instead of using APT?
Usually not. Docker’s repository method is easier to maintain and supports package-managed updates. A manual Compose binary does not update automatically, so you must manage replacement, version tracking, and rollback yourself. Use it only when repository packages cannot meet your operating requirements.
The Bottom Line
For a maintainable Linux VPS, install Docker Engine and the Compose plugin from Docker’s official Ubuntu or Debian repository, verify the daemon and plugin, validate your Compose file, then launch it with docker compose up -d. Publish only necessary ports, account for Docker’s firewall behavior, and protect your volumes and Docker socket.
Quick Recap
Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.
Free tools Windows power users keep installed
One-click scans. No signup required.
