A Makefile can give your Ubuntu VPS a safe, repeatable command interface for deployment, service restarts, log inspection, backups, and cleanup. You run named targets such as make deploy or make status instead of retyping long shell commands, while GNU Make handles variables, prerequisites, and dependency checks.
Need a server to try this on? Antihost offers Linux VPS plans with NVMe storage, full root access and a 14-day free trial.
The safest VPS Makefile has a read-only default target, explicit names for mutating operations, .PHONY declarations for action targets, quoted variables, preflight checks, and a dry-run workflow. The guide below builds that structure and explains when a shell script is a better fit.
As an Amazon Associate I earn from qualifying purchases.
Recommended Free Tools
What Make does on a VPS
GNU Make is both a dependency engine and a command runner. A rule names a target, lists optional prerequisites, and supplies a recipe. Make compares the target with its prerequisites and decides whether the recipe needs to run. The traditional use is rebuilding files, but a VPS operations Makefile can use targets as names for actions such as checking a service or deploying a checked-out revision.
For example, deploy can represent a sequence that verifies the application directory, updates the checkout, restarts a systemd unit, and reports the resulting status. The target is an interface for an operator; the recipe remains ordinary shell commands executed by Make.
#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.
Make does not provide a VPS security policy. It executes the recipes you write, with the permissions and shell available to the account running it. You must therefore design privilege boundaries, secret handling, confirmation checks, and rollback behavior yourself.
Prerequisites and a sensible file location
What you need
- An Ubuntu VPS with SSH access and a user allowed to run the required service commands.
- GNU Make installed on the server. On a standard Ubuntu installation it is normally available with the build tool packages; verify with
make --versionbefore relying on a Makefile. - A shell, Git if the deployment pulls a repository, and the project-specific commands used by your recipes.
- A systemd service unit if targets will call
systemctlorjournalctl. - A version-controlled operations directory or application repository where the Makefile can be reviewed and changed with the rest of the deployment definition.
Where to put the Makefile
Keep the file in the repository or operations directory that owns the deployment. If the application lives in /srv/myapp, you might check the Makefile into that repository and invoke it from the checkout. If you maintain several services, a separate operations repository can hold one Makefile per environment, provided the paths and service names are explicit.
Quick wins for a faster PC:
Repair Windows errors before they cause bigger problemsFix Now →Fix the driver behind crashes, sound loss and screen glitchesFind Drivers →Clear out junk files and repair common Windows errorsFree Scan →Do not scatter copies across home directories. A single reviewed file prevents one operator from restarting a different service or using a stale path. The command should be run from the directory containing the Makefile, or with -C to select it explicitly, for example make -C /srv/myapp status.
A practical Ubuntu VPS Makefile
This skeleton establishes a safe default, central variables, read-only inspection targets, and explicit mutating operations. Replace the service name and paths with values for your server.
.DEFAULT_GOAL := help
SHELL := /bin/bash
APP_DIR ?= /srv/myapp
SERVICE ?= myapp
REVISION ?= main
.PHONY: help setup lint check build deploy restart status logs backup rollback clean
help: ## Show available commands
@grep -E '^[a-zA-Z0-9_-]+:.*## ' $(MAKEFILE_LIST) | sed 's/:.*## / - /'
setup: ## Install or configure project prerequisites
@test -d "$(APP_DIR)" || (echo "Missing APP_DIR=$(APP_DIR)" >&2; exit 1)
lint: ## Run project validation without changing service state
./scripts/lint.sh
check: ## Run health checks without deploying
./scripts/check.sh
build: ## Build an artifact or container image
./scripts/build.sh
status: ## Show service status
sudo systemctl status "$(SERVICE)" --no-pager
logs: ## Show recent service logs
sudo journalctl -u "$(SERVICE)" -n 100 --no-pager
deploy: ## Deploy the checked-out revision
@test -d "$(APP_DIR)" || (echo "Missing APP_DIR=$(APP_DIR)" >&2; exit 1)
git -C "$(APP_DIR)" pull --ff-only
sudo systemctl restart "$(SERVICE)"
$(MAKE) status
restart: ## Restart the service
sudo systemctl restart "$(SERVICE)"
backup: ## Run the project backup command
./scripts/backup.sh
rollback: ## Restore an explicitly selected revision
@test -n "$(REVISION)" || (echo "Set REVISION=..." >&2; exit 1)
git -C "$(APP_DIR)" fetch --all --tags
git -C "$(APP_DIR)" checkout "$(REVISION)"
sudo systemctl restart "$(SERVICE)"
clean: ## Remove generated local artifacts
rm -rf -- build/
Every recipe line begins with a tab under normal GNU Make syntax. Spaces before a command produce the familiar “missing separator” error. In an editor, configure visible whitespace or insert a real tab rather than relying on indentation that only looks like a tab.
The help recipe reads the comments marked with ##, so adding a documented target automatically adds it to the command index. Keep comments accurate: an operator should be able to tell from make help whether a target changes production state.
Design targets around operator questions
help: make discovery safe
Set .DEFAULT_GOAL := help and put a harmless help target first in the file. A bare make then prints the available commands instead of unexpectedly deploying, restarting, or deleting files. GNU Make otherwise commonly uses the first rule as its default goal, so relying on rule order is fragile when someone adds a new target above it.
status and logs: inspect before changing state
Use systemctl status for the unit’s current state and journalctl for recent messages. The --no-pager option keeps output usable over SSH and in automation. The example limits logs to the most recent 100 entries; change the count deliberately when investigating an incident.
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
check, lint, and build: separate validation from deployment
A validation target should not silently restart a production service. Keep syntax checks, application health checks, and artifact creation separate from deploy. This separation lets an operator run make check or make build and review failures before any production mutation occurs.
deploy: make the sequence deterministic
The sample uses git pull --ff-only, which refuses to create an implicit merge when the local branch and its upstream have diverged. The recipe then restarts the named systemd service and invokes $(MAKE) status to show the result. Calling the $(MAKE) variable, rather than a literal make, preserves Make’s command-line options when one target invokes another.
Do these 3 things before closing this tab:
1Clear out junk files and repair common Windows errors2Scan for outdated or missing drivers - takes under a minute3Repair Windows errors before they cause bigger problemsFor a real deployment, add the project’s own build, migration, or health-check commands in an intentional order. If a migration is irreversible, give it a separate target and require an explicit operator decision instead of hiding it inside a routine deploy.
backup, rollback, and clean: name risk honestly
A backup target should call a project script that reports success or failure and verifies the destination. A rollback target should require an explicit revision, tag, or other known-good identifier; never make it silently guess which version to restore. The example accepts REVISION, fetches repository references, checks out that value, and restarts the service.
Use clean only for generated artifacts such as a local build/ directory. A target with that name should never remove uploaded files, databases, backups, or other production data by default.
Why action targets need .PHONY
Targets that represent actions are not files. If a file named status happens to exist in the directory, Make may consider the target up to date and skip its recipe unless you declare it phony:
.PHONY: status logs deploy restart backup rollback cleanGNU Make’s phony declaration tells Make to run the recipe whenever the target is requested, and it avoids an unnecessary implicit-rule search. This is why operational actions belong in .PHONY.
Do not attach a phony action as a prerequisite of a real file target unless you intentionally want the action to execute every time. For example, making a file-producing target depend on deploy would cause a deployment on every rebuild, defeating the dependency model and potentially restarting production repeatedly.
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)
Variables make one file reusable
Make variables are named text values substituted into targets, prerequisites, recipes, and other sections of the file. Define values that differ by host or environment once, then quote their expansions where the shell interprets them as paths or names.
APP_DIR ?= /srv/myapp
SERVICE ?= myapp
REVISION ?= main
SSH_HOST ?= app.example.internal
The ?= operator supplies a default only when the variable was not already set. An operator can therefore select a different checkout and service without editing the file:
Free tools Windows power users keep installed
One-click scans. No signup required.
make deploy APP_DIR=/srv/blue SERVICE=blue-api REVISION=release-2026-10
Document acceptable values in help or a separate comment. Do not use a free-form variable where an arbitrary value could point a destructive command at the wrong directory. For especially sensitive operations, validate the value against an allowlist in the recipe before invoking sudo or deletion commands.
Keep passwords, private keys, API tokens, and database credentials out of the Makefile. Use protected environment files, the service’s existing secret mechanism, or a dedicated secret manager. A version-controlled Makefile is visible to every person and system that can read the repository.
How to invoke and review targets
Run commands from the directory containing the Makefile:
make # show the safe command index
make status # inspect service state
make logs # inspect recent logs
make check # run validation
make deploy # run the guarded deployment recipe
make backup # create a backup
make clean # remove generated artifacts
make -n deploy # print commands without executing them
The -n dry run prints recipes so you can verify paths, service names, revisions, and privilege boundaries before a mutating target runs. It is a review aid, not a substitute for testing the commands in a staging environment: shell conditionals, command substitutions, and permission behavior can differ when a command actually executes.
For a remote execution workflow, SSH to the VPS first and run the Makefile there so that relative paths, credentials, and systemd access are unambiguous. If you use a local Makefile as a wrapper around SSH, make the remote host and command visible in the recipe and quote the boundaries carefully; otherwise a local variable can be expanded before it reaches the server.
Guard production-changing operations
Use a short preflight section in every target that can change state. The goal is to fail before a restart, checkout, migration, or deletion occurs.
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
- Check that
APP_DIRexists and is the expected repository, rather than assuming the current directory. - Verify the selected branch or revision and refuse empty rollback arguments.
- Check required environment variables and executable commands before beginning a multi-step recipe.
- Use deterministic update commands such as
git pull --ff-onlyinstead of allowing an implicit merge. - Keep
status,logs, andcheckseparate fromdeploy,restart, androllback. - Require an explicit confirmation for destructive operations, for example
CONFIRM=1 make destroy, and make the recipe reject every other value. - Record the deployed revision, timestamp, and operator identity in the deployment log so a rollback has an auditable starting point.
- Grant
sudoonly for the narrowly scoped service commands the operator needs. Do not run the entire Makefile as root merely because one recipe callssystemctl.
Quote expansions such as "$(APP_DIR)" and "$(SERVICE)". Without quotes, a path containing whitespace can be split into multiple shell arguments; an empty or unexpected value can also change the command’s meaning.
Handling permissions and service commands
Most application files should remain owned by the deployment user, while systemd control may require a narrowly scoped sudo rule. Test each recipe as the account that will operate the server. A command that succeeds in an interactive root shell may fail for the intended user because of a missing permission, environment variable, working directory, or non-interactive terminal.
Do not place sudo around the whole target. Keep it directly on the command that needs elevation, such as sudo systemctl restart "$(SERVICE)". This makes the privilege boundary visible in dry runs and code review. If sudo requests a password during an automated session, arrange an approved non-interactive policy or stop and investigate rather than embedding a password in the Makefile.
Choosing Make or a shell script
Make and shell scripts overlap, but they solve different parts of an operations workflow.
| Decision factor | Makefile | Shell script |
|---|---|---|
| Discoverability | Named targets provide a conventional make target interface and a central help listing. |
The operator must know the script name and its arguments, or read a separate usage message. |
| Dependency behavior | Can skip work when targets and prerequisites are already up to date; phony targets intentionally run on request. | Normally runs its sequence each time unless you implement your own checks. |
| Portability | Requires GNU Make syntax plus shell commands that exist on the server; POSIX make has a narrower feature set. | Requires a compatible shell and the commands used by the script. |
| Auditability | A small file keeps common commands and variables visible in one place. | Long or branching workflows are often clearer in a versioned script with functions, structured error handling, and tests. |
| Privilege boundaries | Still requires explicit sudo, secret, and destructive-operation controls. |
Has the same requirements; choosing a script does not make privileged commands safer automatically. |
Use Make when you want a concise command index, a few independent operational actions, and simple prerequisites. Move a workflow into a shell script when it has substantial branching, loops, structured logging, argument parsing, or error recovery. The Make target can remain a discoverable wrapper, for example deploy: ./scripts/deploy.sh, while the script owns the complex logic.
The Tool Desk
Outbyte PC Repair FREEClear out junk files and repair common Windows errorsFree Scan →Outbyte Driver Updater FREEFix the driver behind crashes, sound loss and screen glitchesFind Drivers →Recursive Make for multi-directory repositories
If a repository has genuinely independent subdirectories with their own Makefiles, a top-level target can delegate to them. GNU Make recommends using the $(MAKE) variable for recursive invocations:
.PHONY: all
SUBDIRS := api web
all:
@for dir in $(SUBDIRS); do $(MAKE) -C $$dir; done
The double dollar sign produces a shell variable reference, so the loop evaluates dir in the shell. Use recursive Make only when the subdirectories have independent build or operations boundaries. For a single VPS deployment, direct recipes are usually easier to audit than a hierarchy that hides which service is being changed.
Troubleshooting common Makefile failures
“Nothing to be done” or “is up to date”
Make believes the target is a file that already exists or that its prerequisites do not require rebuilding. If the name is an action such as deploy or restart, add it to .PHONY. If it is a real generated file, inspect timestamps and prerequisites instead of forcing it phony.
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.
“missing separator”
A recipe line normally starts with a tab, not spaces. Show invisible characters in your editor, replace the indentation with a real tab, and check that the error is on the command line rather than the target declaration.
What’s actually slowing this PC down?
Pick the symptom - the matching free tool is one click away.
A target runs the wrong service or directory
Print the effective values with make -n target, then inspect command-line overrides and environment variables. Quote the variable and set a safe default with ?=. If multiple environments use the same file, require an explicit variable or separate configuration rather than guessing from the hostname.
sudo fails or hangs
Run the exact command manually as the deployment user, confirm the account’s permissions, and verify that the systemd unit name is correct. A non-interactive SSH session may not be able to prompt for a password. Fix the approved privilege configuration or stop the operation; never put a password in the Makefile.
Git refuses to update during deploy
git pull --ff-only intentionally stops when local and remote history diverge. Inspect the repository, decide whether the local changes should be preserved, and resolve the branch state explicitly. Do not replace the command with an automatic merge merely to make the target succeed.
The service restarts but is unhealthy
Run make status and make logs immediately. Add an application-specific health check after the restart and make the target fail if that check fails. A successful systemctl restart only proves that systemd accepted the request; it does not prove that the application completed startup or can serve traffic.
Windows Errors? Fix Them Before They Spread
Repair common Windows errors and clear accumulated junk for a smoother, more stable PC - no reinstall needed.Free scan · no reinstallCrashes, No Sound, or Screen Glitches?
Random freezes, missing sound and display glitches usually trace back to one bad driver. Find and replace yours safely.Free scan · under a minuteA repeatable deployment routine
- Connect to the VPS and change to the repository or operations directory.
- Run
make helpand confirm that the expected service and environment targets are present. - Run
make status,make logs, andmake checkto establish the current state before changing anything. - Review
make -n deploy. Confirm the application directory, Git command, service unit, and every command that will run with elevated privileges. - Create or verify a backup with
make backupwhen the release changes persistent data or configuration. - Run
make deploywith explicit variable overrides if this host does not use the defaults. - Inspect the resulting status and recent logs. If the health check fails, stop further changes and select a known revision for
make rollback REVISION=.... - Record the deployed revision and any operator notes in the system used for incident or change tracking.
This sequence keeps observation, validation, mutation, and recovery distinct. It also leaves a visible command trail that another administrator can reproduce during an outage.
Keeping the Makefile maintainable
- Give every target one clear purpose and a description in the help listing.
- Prefer short recipes that call tested project scripts over embedding hundreds of lines of shell in the Makefile.
- Keep environment-specific values in variables, but validate overrides before using them.
- Review changes to deployment and rollback targets like application code; a one-line path change can affect production.
- Test targets on a staging VPS with the same Ubuntu release, service names, filesystem layout, and privilege policy as production.
- Keep generated artifacts and logs out of the repository unless they are intentionally versioned.
- Document which targets are read-only, which restart services, and which can delete or restore data.
With these conventions, make becomes a small, inspectable control surface for routine VPS work rather than an opaque collection of commands. The file remains useful as the application grows, while complex behavior can move into separately tested scripts without sacrificing a discoverable operator interface.
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.
