Stop systemd from mangling your service environment variables

Technical Briefing | 7/17/2026

We have all been there. You set an environment variable in your shell profile, restart your service, and act confused when it fails to pick up the change. It is tempting to blame the application or perhaps a botched deployment script, but usually, it is just systemd ignoring the shell environment entirely because, well, it is not a shell.

Why systemd does not care about your profile

Most admins assume that if they can see a variable in their own session, every process they launch will inherit it. systemd launches services as clean-slate processes. It intentionally isolates the service from your messy user-space environment. If you need a specific path or an API key, you have to tell systemd explicitly, or it simply will not exist when your binary starts.

systemctl show-environment
systemctl set-environment DATABASE_URL=postgres://user@localhost/db
systemctl show-property --value --property=Environment my-service

• Environment= directives in the unit file are the most predictable way to inject values.
• EnvironmentFile= is cleaner if you have a dozen keys and do not want to clutter your unit definition.
• Use systemctl import-environment only for transient debugging, as it carries too much baggage from your current shell.

The trap of local configuration

The real danger is when people start sourcing files inside an ExecStart command like ExecStart=/bin/bash -c ‘source /etc/profile && /usr/bin/app’. Do not do this. It turns your unit file into a brittle shell script and hides where your config is actually coming from. If you are struggling with a complex environment, just dump it to a dedicated file and let the service manager handle the heavy lifting.

If you find yourself chasing ghosts in your logs, run systemctl show on your service unit. It will list the active environment as the manager actually sees it. If the variable is not in that output, it does not exist, and no amount of debugging your application code is going to change that reality.