Back to all templates
Nexus Repository logo

Nexus Repository

Development2048MB+ RAM

Universal artifact repository manager

artifactsrepositorypackages

Deploy Nexus Repository in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Nexus Repository

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Nexus Repository on a VPS with Server Compass

Use the Nexus Repository template in Server Compass to deploy a self-hosted artifact repository manager on your VPS, then verify the Nexus 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 Nexus Repository 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 Nexus Repository

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

Searching for Nexus Repository in the Server Compass template picker
4
Step 4

Select the Nexus Repository template

Choose the Nexus Repository template. Server Compass fills the Nexus service, persistent data volume, and web port.

Nexus Repository template selected in Server Compass
5
Step 5

Review the Nexus Repository settings

Confirm the app name and compose services. In this run, the app was named nexus-demo and used host port 8081.

Reviewing Nexus Repository project settings and compose services
6
Step 6

Deploy Nexus Repository

Review the generated compose settings, confirm the web port is available, and click Deploy Now.

Reviewing Nexus Repository environment variables and port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Nexus Repository image, starts the container, and verifies the stack.

Server Compass deploying the Nexus Repository template on the VPS
8
Step 8

Confirm Nexus Repository is running

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

Nexus Repository template running in the Server Compass Apps tab
9
Step 9

Open Nexus Repository in the browser

Click Open Application or open the application URL in a browser. The Nexus Repository Manager web UI confirms the artifact repository is reachable and ready for final setup.

The deployed Nexus Repository Manager web UI loaded in a browser

After Nexus Repository Opens

  • Retrieve the initial admin password from the Nexus data volume before completing setup.
  • Store the administrator credentials and repository tokens in a secure password manager.
  • Add a domain and HTTPS before exposing package repositories publicly.
  • Create repositories, cleanup policies, users, and blob-store backup rules before production use.
  • Back up the Nexus data volume before relying on it for production artifacts.

Verified Result

The Nexus Repository web UI loaded successfully in a browser.

Nexus Repository deployment questions

What does the Nexus Repository template deploy?

It deploys the Sonatype Nexus Repository Manager container with a persistent Nexus data volume.

Which port did the tutorial use?

The tutorial used host port 8081, which maps to the Nexus Repository web UI on container port 8081.

Why does the browser verification stop at the first web UI screen?

A fresh Nexus Repository deployment is considered reachable when the web UI loads. Completing setup and creating repositories depends on production repository policy.

Should this become a blog post?

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

CLI Deployment

Deploy Nexus Repository Yourself

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

1

Establish SSH Connection

Connect to your remote server using SSH. Make sure you have your server credentials ready.

terminal
# Log into your server
ssh root@<your-server-ip>

# If using key-based auth
ssh -i ~/.ssh/my-key root@<your-server-ip>

First time? Docker not installed? Run: curl -fsSL https://get.docker.com | sh

2

Create Project Directory

Set up a directory to store your Docker configuration.

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

Configure Docker Compose

Add this configuration to your docker-compose.yml file:

docker-compose.yml
services:
  nexus:
    image: sonatype/nexus3:latest
    ports:
      - "8081:8081"
    volumes:
      - nexus_data:/nexus-data
    restart: unless-stopped

volumes:
  nexus_data:
Required Settings
PORTHost port(default: 8081)
4

Start the Services

Execute the deployment and check the container status.

terminal
# Deploy the application
docker compose up -d

# Check container health
docker compose ps

# Monitor logs
docker compose logs -f --tail=100
5

Allow Incoming Connections

Enable network access by updating your firewall rules.

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

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

Too complicated? Let Server Compass handle it.

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

  • Intuitive dashboard
  • Deploy in 3 minutes
  • Free SSL included
  • Blue-green deploys
  • Real-time logs
  • Version history
Download Server Compass$29 one-time • Lifetime license

After Deployment

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

1

Get initial admin password

2

Complete setup wizard

3

Create repositories

Need help? Check out our documentation for detailed guides.

Nexus Repository FAQ

Common questions about self-hosting Nexus Repository

How do I deploy Nexus Repository with Server Compass?

Simply download Server Compass, connect to your VPS, and select Nexus Repository 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 Nexus Repository?

Nexus Repository requires a minimum of 2048MB RAM. We recommend a VPS with at least 4096MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Nexus Repository data?

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

How do I update Nexus Repository to the latest version?

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

Is Nexus Repository free to self-host?

Nexus Repository 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 Nexus Repository?

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

Download Server Compass