Getting Started with azlin¶

Welcome to azlin! This guide will help you set up and create your first Azure development VM in minutes.

What You'll Learn¶

In this section, you'll learn how to:

1. Install azlin - Get azlin set up on your system
2. Quick Start - Create your first VM in 5 minutes
3. First VM - Detailed walkthrough of VM creation
4. Basic Concepts - Understand azlin's core concepts

Prerequisites¶

Before you start, make sure you have:

• Azure Account - Create a free account
• Python 3.11+ - Download Python (only needed for uvx or Python bridge)
• Azure CLI - Install Azure CLI
• SSH Client - Pre-installed on macOS/Linux, Download for Windows

Quick Start¶

If you just want to dive in:

# Install azlin
uvx --from git+https://github.com/rysweet/azlin azlin new

# Login to Azure
az login

# Create your first VM
azlin new --name myproject

That's it! azlin will guide you through the rest.

Learning Path¶

1. New to Azure?¶

Start with Installation to set up Azure CLI and authentication.

2. Experienced Azure User?¶

Jump to Quick Start to create your first VM immediately.

3. Want to Understand More?¶

Read Basic Concepts to understand how azlin works.

4. Ready to Explore?¶

Check out Authentication for advanced auth setups.

What's Next?¶

After creating your first VM:

• Connect to VMs - SSH into your VMs
• Manage Storage - Set up shared NFS storage

Need Help?¶

• In-app help: Run azlin --help or azlin <command> --help
• FAQ: Check Frequently Asked Questions
• GitHub Issues: Report bugs
• Discussions: Ask questions

Ready to begin? Start with Installation →