Back to all templates
Nomad logo

Nomad

Infrastructure512MB+ RAM

HashiCorp workload orchestrator

orchestrationhashicorpcontainers

Deploy Nomad in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Nomad

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Nomad on a VPS with Server Compass

Use the Nomad template in Server Compass to deploy a HashiCorp Nomad dev agent on your VPS, then verify the web UI in a browser.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Nomad app
2
Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template
3
Step 3

Search for Nomad

Use the template picker search to find Nomad in the Server Compass template catalog.

Searching for Nomad in the Server Compass template picker
4
Step 4

Select the Nomad template

Choose the Nomad template. Server Compass fills the dev agent service, persistent data volume, Docker socket mount, and HTTP/RPC/Serf ports.

Nomad template selected in Server Compass
5
Step 5

Review the Nomad settings

Confirm the app name and compose service. In this run, the app was named nomad-demo and used host port 4646.

Reviewing Nomad project settings and compose service
6
Step 6

Deploy Nomad

Review the generated compose settings, confirm the Nomad HTTP, RPC, and Serf ports are available, and click Deploy.

Reviewing Nomad environment variables and ports before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Nomad image, starts the dev agent, and verifies the stack.

Server Compass deploying the Nomad template on the VPS
8
Step 8

Confirm Nomad is running

After deployment finishes, return to the Apps tab and confirm the Nomad app is marked Running with its application URL available.

Nomad template running in the Server Compass Apps tab
9
Step 9

Open Nomad in the browser

Open the application URL with /ui appended. The Nomad web UI confirms the workload orchestrator is reachable.

The deployed Nomad web UI loaded in a browser

After Nomad Opens

  • Do not use Nomad dev mode as a production orchestrator.
  • Use a VPN, IP allowlist, firewall rule, or authenticated reverse proxy for production access.
  • Enable ACLs and production-grade server/client configuration before real workloads.
  • Review the Docker socket mount and privileged runtime before using this on shared hosts.
  • Back up the Nomad data volume before moving or replacing the VPS.
  • Keep the Nomad image updated for dependency and security fixes.

Verified Result

The Nomad web UI loaded successfully from the deployed dev agent.

Nomad deployment questions

What does the Nomad template deploy?

It deploys a HashiCorp Nomad dev agent with a persistent data volume, Docker socket mount, and HTTP/RPC/Serf ports.

Which port did the tutorial use?

The tutorial used host port 4646, which maps to the Nomad HTTP API and UI on container port 4646. The template also exposes RPC and Serf ports on 4647 and 4648.

Is this production-ready Nomad?

No. The template runs Nomad in dev mode. Use it for evaluation, then configure a production Nomad cluster with ACLs before real workloads.

Should this become a blog post?

No. The deployment guide should live on the Nomad template detail page and be linked from the reusable template deployment docs page.

CLI Deployment

Deploy Nomad Yourself

Want full control? Here's how to deploy Nomad yourself using Docker Compose.

1

Connect to Your VPS via SSH

Fire up your terminal application and establish a connection to your remote server.

terminal
# Access your VPS
ssh root@YOUR_SERVER_IP

# With SSH key authentication
ssh -i ~/.ssh/your-private-key root@YOUR_SERVER_IP

First time? Ensure Docker is installed first: curl -fsSL https://get.docker.com | sh

2

Initialize Project Folder

Create a folder to house your Docker Compose configuration.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/nomad
cd ~/apps/nomad
3

Create Docker Configuration

Define your services in a docker-compose.yml file:

docker-compose.yml
services:
  nomad:
    image: hashicorp/nomad:1.7.7
    command: agent -dev -bind=0.0.0.0
    ports:
      - "4646:4646"
      - "4647:4647"
      - "4648:4648"
    environment:
      - NOMAD_SKIP_DOCKER_IMAGE_WARN=true
    volumes:
      - nomad_data:/nomad/data
      - /var/run/docker.sock:/var/run/docker.sock
    privileged: true
    restart: unless-stopped

volumes:
  nomad_data:
Required Settings
PORTHTTP API port(default: 4646)
RPC_PORTRPC port(default: 4647)
SERF_PORTSerf port(default: 4648)
4

Execute the Deployment

Start your containers and verify they're running correctly.

terminal
# Launch the stack
docker compose up -d

# Verify container status
docker compose ps

# Follow the logs
docker compose logs --follow
5

Allow Network Access

Update UFW rules to allow traffic on the application port.

terminal
# Allow the application port through firewall
sudo ufw allow 4646/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:4646
Skip the Terminal

Don't want to type commands? We've got you.

Skip the terminal and deploy Nomad with a visual interface. Configure everything with clicks, not commands.

  • No terminal required
  • Point-and-click setup
  • Auto SSL certificates
  • Rolling deployments
  • Health monitoring
  • Instant rollbacks
Download Server Compass$29 one-time • Lifetime license

After Deployment

After deploying Nomad with Server Compass, complete these steps to finish setup

1

Access Nomad UI

2

Submit jobs

3

Configure ACLs for production

Need help? Check out our documentation for detailed guides.

Nomad FAQ

Common questions about self-hosting Nomad

How do I deploy Nomad with Server Compass?

Simply download Server Compass, connect to your VPS, and select Nomad from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Nomad?

Nomad requires a minimum of 512MB RAM. We recommend a VPS with at least 1024MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Nomad data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Nomad backup and restore procedures.

How do I update Nomad to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Nomad image will be pulled and deployed with zero downtime.

Is Nomad free to self-host?

Nomad is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Ready to Self-Host Nomad?

Download Server Compass and deploy Nomad to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass