Documentation
Learn how to set up your servers and configure your remote agents.
Getting Started & Chatting
Axolotl allows you to connect directly to your VPS and manage it using natural language. Here is how to create a connection and start chatting.
1. Add a New Connection
Open the Axolotl desktop application and click on Add New Connection. You will need to provide the following details:
- Name: A friendly name for your server (e.g., "My VPS").
- Host: The IP address or hostname of your server.
- Username: Your SSH username, typically
rootorubuntu. - Password / Key: Your SSH password or private key.
- Port: The SSH port, usually
22.
Click Save to establish the connection.
2. Start Chatting
Once the connection is established and healthy, the Axolotl agent will be initialized on your server.
- Open the workspace for your new connection.
- Use the chat interface at the bottom to ask the agent to perform tasks, such as "Install Docker" or "Check my disk usage".
Setting up the Telegram Bot
You can control your server agent remotely from your phone using a private Telegram bot.
Create a Bot on Telegram
Open Telegram and search for @BotFather. Send the /newbot command, follow the instructions to name your bot, and copy the HTTP API Token provided at the end.
Configure Token in Axolotl
In the Axolotl desktop app, open your connection's settings menu (three dots) and select Telegram Bot.
- • Paste your Bot Token.
- • Leave Allowed Chat IDs empty for now.
- • Check Enable Telegram bot and click Save & Push.
Get your Telegram Chat ID
Open Telegram and start a chat with your newly created bot. The bot will reply with a warning message:
...
Your Chat ID is: 987654321
Whitelist your ID
Copy the Chat ID from Telegram, go back to the Axolotl app, and paste it into the Allowed Chat IDs field. Click Save & Push again to lock down the bot!