Register a server

Register your server with Alpacon to manage it from your browser.

What is a user server?

A user server refers to a server operated by an individual user or a group of users. Alpacon supports registration and management of both:

  • Cloud-based servers (e.g., AWS, GCP, Azure)
  • On-premise servers operated directly by the user

Even in hybrid environments where different types of servers coexist, Alpacon offers a consistent UI/UX to manage all servers seamlessly in one place.

Key benefits:

  • Unified management interface for all server types
  • Consistent experience regardless of server location
  • No distinction needed between cloud and on-premise
  • Centralized control and monitoring

Registration process

1. Enter server information

  1. Click Servers in the left sidebar
  2. Click Connect Server button in the top right
  3. In the Quick View panel, enter:
    • Name: Identifier for your server (e.g., web-server-01)
    • Platform: Select server OS (Ubuntu, Debian, RHEL, CentOS, etc.)
    • Authorized groups: Select groups that can access this server (optional)
    • Alert rules: Select alert rules to apply to this server; default alert rules are always applied (optional)
  4. Click Save

2. Install Alpamon agent

An installation script is automatically generated and displayed on screen.

Installation steps:

  1. Copy the generated installation script
  2. Connect to your target server’s terminal
  3. Paste and run the script
  4. Wait for installation to complete (takes about 1-2 minutes)

Script example:

curl -sSL https://install.alpacon.io/agent | sudo bash -s -- --token YOUR_TOKEN

3. Verify connection

  1. Click Close in the installation modal
  2. Check the server in the server list
  3. Status should show Connected when successful

Supported platforms

Debian-based:

  • Ubuntu
  • Debian

Red Hat-based:

  • RHEL (Red Hat Enterprise Linux)
  • CentOS
  • Amazon Linux
  • Rocky Linux
  • Fedora
  • Oracle Linux

Requirements

Server requirements:

  • Linux-based operating system
  • Internet connection
  • sudo privileges (for installation)

Network:

  • Outbound HTTPS connections allowed (port 443)
  • Access to Alpacon API servers

Troubleshooting

Connection status shows “Disconnected”:

  1. Check agent status:
sudo systemctl status alpamon
  1. Restart agent:
sudo systemctl restart alpamon
  1. Check logs:
sudo journalctl -u alpamon -n 50

Installation fails:

  • Verify sudo privileges
  • Check internet connection
  • Confirm platform is supported

Security considerations

Agent communication:

  • All communication is TLS encrypted
  • Only outbound connections from server to Alpacon required
  • No inbound ports need to be opened

Authentication:

  • Each server uses a unique token for authentication
  • Token is only used during installation and stored securely

Next steps

After registering your server: