Quickstart

A 5-minute guide for first-time Alpacon users. Follow this guide to quickly experience everything from workspace creation to your first server connection.

Before you start

What you need to use Alpacon:

• Alpacon account (Sign up)
• A server to manage (Linux-based: Ubuntu, Debian, RHEL, CentOS, etc.)
• SSH access to the server

Step 1: Create a workspace (1 min)

A workspace is an independent space for managing servers and team members.

1. Log in to Alpacon
2. Click Start with a new workspace in the center
3. Enter workspace name (e.g., my-production), URL, and your country
4. Click Create

Once created, a dedicated workspace URL will be automatically assigned. Example: https://alpacon.io/my-production/

💡 Tip: You can create separate workspaces for dev/staging/production environments.

Step 2: Register your first server (2 min)

2-1. Start server registration

In your Alpacon workspace:

1. Click Servers in the left menu
2. Click Connect Server button
3. In the Connect Server quick view, enter:
   • Name: Server identifier (e.g., web-server-01)
   • Platform: Select server platform (Ubuntu, Debian, RHEL, CentOS, etc.)
   • User Groups (Optional): Select user groups that can access the server
4. Click Save

2-2. Install Alpamon agent

1. Copy the generated setup script
2. SSH into your server and paste the script to execute it
3. Click Close in Alpacon
4. Verify the server status shows Connected in the server list

Step 3: Connect to server via web terminal (1 min)

Now let’s connect to the server directly from your browser.

1. Choose the server you want to connect to from the Servers list
2. Click the Terminal icon to connect to the server

🎉 Done! You’ve connected to your server from the browser without a separate SSH client.

Try key Websh features

Once the terminal is open, try these features:

• Execute commands: Use like a normal terminal: ls, top, df -h, etc.
• Session persistence: Sessions remain active even if you close the browser tab (reconnect to resume work)
• Customize settings: Click ⚙️ icon in the terminal to adjust theme and font size

Step 4: Invite team members (Optional, 1 min)

💎 This feature is available in Essentials plan or higher (paid version).

You can invite team members to share server access. Only users with staff or superuser privileges can invite team members.

1. Click IAM > Users in the left menu
2. Click Add New User button
3. Enter the email address of the member to invite
4. Click Send Invitation

Invited members will receive a signup link via email, which remains valid for 48 hours.

IAM permission levels

• User: Regular users who can only access resources within their granted permissions
• Staff: Users with administrative privileges who can execute some admin functions
• Superuser: Full administrative access and system-wide configuration privileges

Next steps

You’ve completed the basic setup! Now explore more Alpacon features:

Enhanced security

• IAM & Group Management - Fine-grained access control and batch permission settings by team
• Monitoring - Server activity logs and auditing

Improved productivity

• Deploy Shell - Template frequently used commands
• WebFTP - File transfer from browser
• Session Sharing - Real-time collaboration with team

Advanced features

• CLI Tool - Manage Alpacon from terminal
• API Integration - Automation and custom integrations

Need help?

• Common issues - Frequently occurring problem resolution
• Connection issues - Server connection problems
• Agent issues - Alpamon agent problems
• Support - Technical support inquiries

Recommended tutorials for new users:

• Complete first workspace setup guide
• Building a secure production environment
• Team collaboration setup