Connect to servers

Alpacon uses session-based access: to work on a server, you request a work session rather than connecting directly. Once the session is approved, you launch the tools you need—browser terminal, file transfer, code editor, command execution, and more.

Note: The first time you click Connect, a brief hint explains this flow: “Request a session to connect. Server access is available once approved.”

Connect to a server

  1. Go to the Servers page.
  2. Find the server you want to work on.
  3. Click Connect—on the server card, or on the server detail page.
  4. The session request form opens with that server already selected.
  5. Choose the features you need, add a purpose and duration, and submit. See Request a session.

After a workspace administrator approves the request, the session becomes Active and you can launch its features.

Note: You can also add several servers to one session. Start from any server’s Connect button, then add more servers in the request form.

Requirements

The Connect button is available only when:

  • The server is commissioned and Online.
  • You belong to a user group assigned to the server (or are a workspace administrator).
  • You’re a workspace member.

If the server is offline or not commissioned, Connect is disabled and the card shows No connection instead of the server address.

Launch tools from the session

Once the session is active, open it and use the Available features card:

  • Web terminal, File transfer, and Code editor open in the browser with a Launch button.
  • Execute commands and Port forwarding are used from the Alpacon CLI after you attach to the session.

For the full walkthrough—launching, attaching from the CLI, extending, and ending a session—see Use a session.

Account selection

When you launch a feature, you work as a specific account on the remote server. On Linux servers you connect as your own IAM account and use sudo with MFA for privileged actions; on Windows and macOS servers you can also select a system account. See Account selection for details.

Troubleshooting

Connect button is disabled:

  • Confirm the server is Online and commissioned.
  • Confirm you’re assigned to a user group with access to the server.

Can’t launch a feature:

  • The session must be Active (approved and within its time window).
  • The file editor and port forwarding require those features to be enabled on the server. See Manage servers.

A tool won’t open in the browser:

  • Disable your browser’s popup blocker, then retry.
Last updated: