How to Deploy a Go App to a VPS with systemd

Compile your Go binary for the target architecture, transfer it to the VPS, and configure a systemd service unit to run it as a background process.

1. Build the binary for the VPS architecture (e.g., linux/amd64) from your local machine. GOOS=linux GOARCH=amd64 go build -o myapp main.go
2. Transfer the compiled binary to your VPS using SCP. scp myapp user@your-vps-ip:/opt/myapp/myapp
3. Create a systemd service file to define how the application should run. sudo nano /etc/systemd/system/myapp.service
4. Paste the service configuration into the file, replacing paths and user details.

   [Unit]
   Description=My Go Application
   After=network.target
   
   [Service]
   User=ubuntu
   WorkingDirectory=/opt/myapp
   ExecStart=/opt/myapp/myapp
   Restart=on-failure
   Environment=PORT=8080
   
   [Install]
   WantedBy=multi-user.target
   

5. Reload systemd to recognize the new service file. sudo systemctl daemon-reload
6. Enable the service to start on boot and start it immediately. sudo systemctl enable myapp && sudo systemctl start myapp
7. Verify the service is running and check its status. sudo systemctl status myapp

Deploying a Go App to a VPS with systemd turns your code into a standalone program that runs automatically on your server. Think of it like setting up a dedicated employee who starts working as soon as the office opens and keeps working even if they trip over a cable. You build the worker, give them a job description (the service file), and tell the manager (systemd) to hire them.