Antlysis VPN Setup Guide
Last updated: 2026-05-07
Overview
Antlysis uses Tailscale connected to our self-hosted Headscale server to provide secure access to internal infrastructure. This guide will walk you through installing and connecting to the VPN on your device.
⚠️ Before you begin: Make sure you have received your personal Auth Key from the DevOps team. Each key is unique to you and expires in 24 hours — connect as soon as possible after receiving it.
Supported Platforms
| Platform | Supported |
|---|---|
| Windows 10/11 | ✅ |
| macOS | ✅ |
| Linux (Ubuntu/Debian/RHEL) | ✅ |
| Android | ✅ |
| iOS | ✅ |
SetupCreating new account
- SSH into Bastion-Host server.
- Create user:
docker exec -it headscale headscale users create <username> - Get user id:
docker exec -it headscale headscale users list - Create preauth key:
docker exec -it headscale headscale preauthkey create -u <USER ID> --expiration 24h --reusable=false
Deleting account
docker exec -it headscale headscale nodes list
Delete nodes with corresponding user:
docker exec -it headscale headscale nodes delete --identifier <NODE ID> --force
Get user ID:
docker exec -it headscale headscale users list
Delete user:
docker exec -it headscale headscale users destroy --identifier <USER ID>
Installation
Windows
-
Download Tailscale from the official website: 👉 https://tailscale.com/download/windows
-
Run the installer and follow the on-screen instructions.
-
Once installed, do NOT sign in through the GUI — we use our own server, not Tailscale's cloud. Open Command Prompt or PowerShell instead.
-
Connect to the Antlysis VPN using your auth key:
tailscale up --login-server https://vpn.antlysis.com --authkey <YOUR-AUTH-KEY> -
Verify your connection:
tailscale status
macOS
-
Download Tailscale from the Mac App Store: 👉 https://apps.apple.com/app/tailscale/id1475387142
Or via Homebrew:
brew install tailscale -
Open Terminal and connect using your auth key:
sudo tailscale up --login-server https://vpn.antlysis.com --authkey <YOUR-AUTH-KEY> -
Verify your connection:
tailscale status
Linux (Ubuntu/Debian)
-
Install Tailscale:
curl -fsSL https://tailscale.com/install.sh | sh -
Connect using your auth key:
sudo tailscale up --login-server https://vpn.antlysis.com --authkey <YOUR-AUTH-KEY> -
Verify your connection:
tailscale status
Android
-
Install Tailscale from the Google Play Store: 👉 https://play.google.com/store/apps/details?id=com.tailscale.ipn
-
Open the app and tap the three dots menu (⋮) in the top right.
-
Tap Use custom coordination server and enter:
https://vpn.antlysis.com -
Tap Connect and enter your auth key when prompted.
iOS
-
Install Tailscale from the App Store: 👉 https://apps.apple.com/app/tailscale/id1475387142
-
Open the app and tap the three dots menu (⋮) in the top right.
-
Tap Use custom coordination server and enter:
https://vpn.antlysis.com -
Tap Connect and enter your auth key when prompted.
Verifying Your Connection
After connecting, run the following to confirm you are connected:
tailscale status
You should see output similar to this:
100.64.0.X your-device antlysis <OS> -
100.64.0.1 bastion-host antlysis linux idle; offers exit node
Testing Access to Internal Servers
Once connected, test that you can reach internal servers based on your role:
# Production Main Server
ping 172.16.0.1
# Production Apps
ping 172.16.2.1
# Sandbox
ping 172.16.1.101
ℹ️ You will only be able to reach servers that your role has been granted access to. If you cannot reach a server you need, contact the DevOps team.
Server Access by Role
Access is granted based on your role. Each role gives you access to a specific section of the Antlysis infrastructure:
🔵 Production Services
Gives access to the core production services servers:
| Server | IP | What's Running |
|---|---|---|
| Production-Main.services | 172.16.0.1 | Portainer, Grafana, Loki, BookStack, Passbolt, NGINX, Node-RED, InfluxDB, MariaDB, MinIO |
| Production-1A.services | 172.16.0.2 | EMQX (MQTT), RabbitMQ, Redis |
| Production-1B.services | 172.16.1.2 | EMQX (MQTT), RabbitMQ, Redis |
🟢 Production Apps
Gives access to the production application servers running all live customer-facing services:
| Server | IP | What's Running |
|---|---|---|
| Production-1A.apps | 172.16.2.1 | Application services (Swarm Worker) |
| Production-2A.apps | 172.16.2.2 | Application services (Swarm Worker) |
| Production-3A.apps | 172.16.2.3 | Application services (Swarm Worker) |
| Production-4A.apps | 172.16.2.4 | Application services (Swarm Worker) |
⚠️ These are live production servers. Be careful with any changes made here.
🟡 Sandbox
Gives access to the sandbox (testing) environment which mirrors production. Safe to test and develop without affecting live services:
| Server | IP | What's Running |
|---|---|---|
| Sandbox-1.services | 172.16.1.101 | Sandbox analog of Production-Main, test/echo services |
| Sandbox-1A.apps | 172.16.2.101 | Sandbox application services (Swarm Worker) |
| Sandbox-1B.apps | 172.16.3.104 | Sandbox application services (Swarm Worker) |
ℹ️ Sandbox uses
:sandboxtagged images. All development and testing should be done here first before promoting to production.
🔴 Apsara DB
Gives access to the Alibaba Cloud ApsaraDB RDS instances hosted in the database subnet. These are the main persistent databases for all applications:
| Subnet | Notes |
|---|---|
| 172.23.32.0/20 | Apsara RDS instances — PostgreSQL/MySQL (Zone B) |
🟠 Internal DB
Gives access to specific internal database and storage containers running on Production-Main.services:
| Service | Port | Purpose |
|---|---|---|
| MariaDB | 3306 | Relational database for internal services |
| InfluxDB | 8086 | Time-series database for metrics |
| MinIO API | 9000 | Object storage API |
| MinIO Console | 9001 | Object storage management UI |
| Loki | 3100 | Log aggregation |
| Prometheus | 9090 | Metrics collection |
| BookStack | 80/443 | Internal documentation wiki |
⚠️ These are production data services. Read/write access depending on your credentials.
Role Assignment Summary
| Role | Production Services | Production Apps | Sandbox | Apsara DB | Internal DB |
|---|---|---|---|---|---|
| Admin | ✅ | ✅ | ✅ | ✅ | ✅ |
| Senior Developer | ❌ | ✅ | ✅ | ✅ | ✅ |
| Junior Developer | ❌ | ❌ | ✅ | ✅ | ✅ |
| Graduate/Intern | ❌ | ❌ | ✅ | ❌ | ❌ |
ℹ️ If you need access to a section not listed under your role, raise a request with the DevOps team.
Disconnecting from the VPN
Windows / macOS / Linux
tailscale down
Mobile
Tap the toggle in the Tailscale app to disconnect.
Reconnecting
Your device stays registered permanently after the first connection. To reconnect after disconnecting:
Windows / macOS / Linux
tailscale up
ℹ️ You do not need your auth key again after the first connection. The auth key is only used once during initial registration.
Troubleshooting
❌ tailscale up hangs or times out
- Check your internet connection.
- Make sure no firewall is blocking outbound connections to
vpn.antlysis.comon port443.
❌ Cannot reach internal servers after connecting
- Run
tailscale statusand confirm you are connected. - Confirm with the DevOps team that your user has been added to the correct ACL groups.
❌ Auth key is invalid or expired
- Auth keys expire after 24 hours. Contact the DevOps team to generate a new key.
❌ missing "Bearer" prefix error
- This is a server-side log message and does not affect your connection. Ignore it.